From a67baffd1fee559165104b1895e7cc4f1cbc8ed3 Mon Sep 17 00:00:00 2001 From: evgeny Date: Thu, 29 Oct 2026 00:28:23 +0100 Subject: [PATCH] Specify call video bitrate, cadence and orientation helper contracts --- .../main/java/com/utun/chat/data/CallVideoBitrateRange.kt | 3 ++- .../app/src/main/java/com/utun/chat/data/CallVideoCadence.kt | 4 +++- .../src/main/java/com/utun/chat/data/CallVideoOrientation.kt | 5 ++++- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoBitrateRange.kt b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoBitrateRange.kt index d8b3d1816..f6af59a85 100644 --- a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoBitrateRange.kt +++ b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoBitrateRange.kt @@ -1,6 +1,7 @@ package com.utun.chat.data -/** Обе границы хранятся одной настройкой в десятичных кбит/с. */ +/** Границы 300..4000 десятичных кбит/с, minimum <= maximum; одна настройка "minimum:maximum". + * Конструктор отвергает неверные границы, parse возвращает null при неверных цифрах/формате/диапазоне. */ data class CallVideoBitrateRange(val minimum: Int = 300, val maximum: Int = 4000) { init { require(minimum in 300..4000 && maximum in minimum..4000) } diff --git a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoCadence.kt b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoCadence.kt index 659432cfa..94a3fb2fa 100644 --- a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoCadence.kt +++ b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoCadence.kt @@ -1,6 +1,8 @@ package com.utun.chat.data -/** Отбор raw кадров по фазе, как в desktop: допуск дрожания PTS, без burst после паузы. */ +/** Worker-локальный отбор raw по фазе fps=1..60; PTS — монотонные мкс одного запуска камеры. + * accept=false при неверном/повторном PTS, риске overflow либо раннем кадре (допуск 1/4 периода). + * Пауза больше периода переносит фазу без burst; новый источник/шкала PTS требует нового экземпляра. */ internal class CallVideoCadence(private val fps: Int) { private var lastPts = -1L private var next = -1L diff --git a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoOrientation.kt b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoOrientation.kt index bff775a59..3838c68c6 100644 --- a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoOrientation.kt +++ b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallVideoOrientation.kt @@ -1,7 +1,10 @@ package com.utun.chat.data /** Угол OrientationEventListener: 90° означает левое ребро сверху, независимо от экрана. - * Первый достоверный отсчёт принимается сразу; далее 60° гистерезис и 250 мс устойчивости. */ + * Первый достоверный отсчёт принимается сразу; далее 60° гистерезис и 250 мс устойчивости. + * observe/confirm вызываются одним worker с монотонными nowMs; неизвестный angle сбрасывает только кандидата. + * rotation(sensor, front) задаёт физический поворот YUV, не поворот UI/прямого preview. + * resetPending не забывает подтверждённый угол между включениями камеры. */ internal class CallVideoOrientation { var degrees = 0 private set