TikTok Live Reader (мониторинг и запись прямых эфиров)

Это дополнение подключается к прямым эфирам TikTok и извлекает информацию в реальном времени. Оно использует Python-библиотеку TikTokLive для доступа к конкретному прямому эфиру. Поддерживаются следующие функции:

• Запись извлеченных данных в текстовые файлы, создаваемые в папке Документы\TikTok live.
• Отслеживание событий: комментарии, новые подписчики, подарки, отметки "Нравится", репосты и посетители.
• Файл событий, который может записывать несколько типов данных одновременно.
• Звуковые уведомления для выбранных событий, таких как новые комментарии, подарки и т. д.
• Статистика эфира: отображает текущее количество зрителей, общее количество посетителей за сессию, общее количество отметок "Нравится", новых подписчиков и собранные алмазы.
• Таблица лидеров "Топ дарителей": ранжирует пользователей от самого активного к наименее активному на основе отправленных алмазов.
• Таблица лидеров "Топ лайков": ранжирует пользователей на основе их общего количества отметок "Нравится" во время эфира.

TikTok Live Reader позволяет ведущим или зрителям отслеживать основные данные эфира без использования внешних инструментов. Данные сохраняются в текстовые файлы в папке Документы\TikTok live и могут быть просмотрены позже. Дополнение извлекает следующие типы данных в отдельные файлы:

• comments.txt — Записывает все комментарии, обнаруженные во время прямого эфира, с указанием времени.
• followers.txt — Регистрирует всех новых пользователей, которые подписались на создателя эфира во время текущей сессии.
• gifts.txt — Регистрирует все полученные подарки с указанием пользователя, типа подарка, количества и времени.
• likes.txt — Показывает, кому понравился эфир, когда и сколько раз.
• shares.txt — Записывает пользователей, которые поделились прямым эфиром, вместе с временной меткой.
• stats.txt — Показывает текущее количество зрителей, новых подписчиков, общее количество отметок "Нравится", общее количество посетителей за сессию и общее количество полученных алмазов.
• top gifts.txt — Таблица лидеров пользователей, отправивших подарки, отсортированная от самых активных к наименее активным.
• top likes.txt — Таблица лидеров пользователей, отсортированная по общему количеству отметок "Нравится".
• visitors.txt — Записывает всех посетителей, заходивших в эфир во время текущей сессии, с указанием времени.
• events.txt — Объединенный хронологический журнал для различных событий (комментарии, подписчики, подарки и т. д.), которые могут быть определены пользователем.

Настройки

TikTok Live Reader имеет собственное окно настроек. Его можно открыть сочетанием клавиш NVDA+Shift+Control+L. Окно настроек содержит 3 вкладки:

Общие

Этот раздел включает следующие настройки:

• Имя пользователя — Введите имя пользователя ведущего прямого эфира TikTok без символа @.
• Очищать текстовые файлы при запуске — Удаляет содержимое текстовых файлов при запуске дополнения.
• Очищать имена пользователей — Удаляет эмодзи и символы Юникода из имён пользователей. Это обеспечивает лучшую совместимость с программами экранного доступа. Когда опция включена, имена пользователей содержат только буквы, цифры и знаки препинания.
• Количество попыток подключения — Определяет, сколько раз дополнение должно пытаться подключиться к прямому эфиру.

События

Эти флажки определяют, какие типы данных записываются в файл событий (Events). Варианты включают комментарии, подписчиков, подарки, отметки "Нравится", репосты и посетителей. Дополнительные параметры:

• Воспроизводить звуки для выбранных событий — Воспроизводит определенный короткий звук при наступлении отмеченного события.
• Громкость звуков — Регулирует уровень громкости звуковых уведомлений.
• Ознакомиться со звуками — Воспроизводит описание различных звуков, чтобы пользователь мог с ними ознакомиться.

Автоматическое проговаривание

Этот раздел определяет, какие события озвучиваются, когда включена функция автоматического проговаривания. Активируйте её с помощью сочетания клавиш NVDA+Shift+Control+S. Когда происходит выбранное событие, оно автоматически озвучивается (например, «Новый подписчик: Имя пользователя» или «Имя пользователя поделился эфиром»). Объявления и звуки воспроизводятся с паузой в одну секунду между ними. Они сохраняются во временных файлах, чтобы гарантировать их воспроизведение по порядку во время оживленных прямых эфиров с высокой нагрузкой. Звуковые уведомления и функция автоматического проговаривания работают независимо.

Как использовать дополнение

После настройки нажмите NVDA+Shift+Control+T для подключения. Статус подключения объявляется автоматически. Следующие горячие клавиши работают только во время активной сессии:

• Control+Shift+Стрелка вправо — Следующий файл (например, Комментарии, События, Подписчики, Подарки и т. д.).
• Control+Shift+Стрелка влево — Предыдущий файл.
• Control+Shift+Стрелка вниз — Следующий элемент в текущем файле (например, комментарий, отметка "Нравится", репост).
• Control+Shift+Стрелка вверх — Предыдущий элемент в текущем файле.
• Control+Shift+Home — Перемещает фокус на первый элемент в текущем файле.
• Control+Shift+End — Перемещает фокус на последний элемент в текущем файле.
• NVDA+Shift+Control+V — Сообщает текущее количество зрителей.
• NVDA+Shift+Control+S — Включает или выключает функцию автоматического проговаривания.
• NVDA+Shift+Control+R — Вручную очищает содержимое текстовых файлов.

Нажмите NVDA+Shift+Control+T, чтобы завершить текущую сессию. Данные остаются доступными в папке Документы\TikTok live.

Примечания

• Открытие настроек завершает активное подключение для обеспечения стабильности при применении изменений.
• Если опция «Очищать файлы при запуске» отключена, новые данные добавляются к существующим журналам. Используйте NVDA+Shift+Control+R для их ручной очистки.
• Дополнение запоминает вашу последнюю позицию в файлах, если они не очищаются автоматически.

Ограничения

• Дополнение не может показать список всех текущих зрителей, потому что библиотека TikTokLive не сообщает, когда пользователь покидает эфир.
• Невозможно создать таблицу лидеров на основе времени просмотра из-за отсутствия событий о выходе пользователя.
• Во время перевода дополнения на болгарский язык (родной язык автора) было установлено, что подарки в TikTok слишком многочисленны и часто обновляются социальной сетью. Поддержка ручного перевода для всех них нецелесообразна. Поэтому названия подарков будут озвучиваться на английском языке.

Заключительные пояснения

Это дополнение было разработано с помощью языковых моделей ChatGPT, Google Gemini и Claude OPUS 4.6 Thinking. Оно распространяется под лицензией GNU General Public License 2.0.