Трансляция турнира в прямом эфире

Что такое трансляция

Трансляция показывает партии турнира, который проходит на досках где-то в другом месте: зрители следят за ходами, часами и движком на странице турнира, пока играется тур. Партии отправляете вы, а ChessLivo их показывает.

Трансляция — это не клубный турнир. Клубный турнир проводится на самом ChessLivo: игроки, жеребьёвка, результаты и рейтинги. Трансляция только показывает партии; жеребьёвка и турнирная таблица берутся из вашей собственной программы или из chess-results, если вы укажете ссылку на неё.

Нужен подтверждённый аккаунт. У одного аккаунта может быть 3 трансляции, которые запланированы или идут в прямом эфире одновременно; завершённые не считаются.

Создание и расписание

1. Откройте Мои трансляции и нажмите Новая трансляция.
2. Укажите название, формат, даты, часовой пояс и видимость и отметьте, что у вас есть права на трансляцию (или что организатор вам это разрешил). Затем нажмите Создать трансляцию.
3. На вкладке Туры добавьте туры кнопкой Добавить тур: название и либо время начала (в часовом поясе трансляции), либо После предыдущего тура. У первого тура должно быть время начала.
4. Нажмите Сохранить расписание.

К названию тура можно добавить перевод через «|», например «Round 1 | 1. tur». Тур переходит в прямой эфир с первым ходом и считается завершённым, когда на каждой доске есть результат; на идущем туре можно также отметить Отметить завершённым. Идущий или завершённый тур нельзя удалить или переместить. Не более 64 туров.

Видимость: трансляции Публичная появляются в списках сайта, как только приходит первый ход; Не в списке видны всем, у кого есть ссылка; Закрытый видны только вам (и управляющим связанного клубного турнира).

Выбор источника

Доски каждого тура поступают одним из двух способов, которые задаются на вкладке Источник:

• Ключ отправки или загрузка: PGN отправляете вы сами — из программы для трансляции, скрипта или со вкладки Загрузить. Лучше всего подходит для досок DGT на вашем ноутбуке.
• Публичный URL: ChessLivo читает публичную ссылку каждые 10 секунд, пока тур идёт в прямом эфире (раз в минуту — начиная за час до старта). Подходят: ссылка на файл PGN, тур на LiveChessCloud, страница прямой трансляции TSF или тур трансляции на Lichess.

1. Выберите источник трансляции и нажмите Сохранить источник. Для ссылки ChessLivo сразу проверяет её и показывает, что нашёл: партии, доски без имён игроков, теги Round.
2. У тура может быть свой источник: откройте его из списка Источники туров. Вариант Источник трансляции по умолчанию следует выбору всей трансляции.

Тур с источником-ссылкой не принимает отправку. Если по ссылке доступно несколько туров, в разделе Дополнительно оставьте только один тег Round (например, 3) или только часть партий по номерам (например, 1-4,11-15).

DGT LiveChess

DGT LiveChess считывает доски DGT и может записывать партии тура в файлы PGN в папку на ноутбуке.

1. В DGT LiveChess укажите папку экспорта PGN для тура.
2. Если включить Combine PGNs per round (настройка программы на английском: «объединять PGN по турам»), программа запишет один файл со всеми партиями, иначе — по файлу на доску. Программа для трансляции принимает оба варианта: для файла на доску запускайте её с параметром --combine.
3. Создайте ключ отправки и запустите программу для трансляции на этой папке.

Следите, чтобы на каждой доске в DGT LiveChess были указаны оба игрока: доска без имени будет отклонена.

LiveChessCloud

Если DGT LiveChess уже публикует тур в LiveChessCloud, программа вам не нужна.

1. Скопируйте ссылку зрителя на тур; она выглядит как view.livechesscloud.com/#…, затем номер тура.
2. На вкладке Источник выберите Публичный URL, вставьте ссылку (только одну) и нажмите Сохранить источник.

Swiss-Manager

Swiss-Manager умеет сохранять партии тура в файл PGN.

1. Экспортируйте тур в PGN из Swiss-Manager.
2. Отправьте файл на вкладке Загрузить или сохраните его в папку, за которой следит программа для трансляции.

Доски сопоставляются по тегу Round вида «тур.доска» (например, «3.12»), затем по тегу Board, затем по порядку партий в файле. Повторная отправка доски обновляет её.

Страница прямой трансляции TSF

1. Скопируйте ссылку на тур с live2.tsf.org.tr.
2. На вкладке Источник выберите Публичный URL, вставьте её и нажмите Сохранить источник.

Зеркало Lichess

Трансляцию, которая уже идёт на Lichess, можно показать и здесь.

1. Откройте тур на Lichess и скопируйте ссылку на него (lichess.org/broadcast/…/round-…/ и идентификатор тура). Ссылки на турнир, группу, партию или студию не принимаются.
2. На вкладке Источник выберите Публичный URL, вставьте её и нажмите Сохранить источник.

Если эта трансляция Lichess уже есть на ChessLivo, ничего не сохраняется, а страница даёт ссылку, где её можно смотреть. Один аккаунт может зеркалировать одну трансляцию Lichess одновременно.

Ключ отправки и программа для трансляции

Ключ отправки позволяет программе присылать PGN в ваши туры.

1. На вкладке Ключ отправки нажмите Создать ключ. Скопируйте ключ сразу: он показывается только один раз.
2. На той же странице перечислены URL для отправки каждого тура, который принимает отправку.
3. Создать ключ заново выпускает новый ключ и сразу отключает старый; Отозвать отключает ключ, пока вы не создадите новый. Завершение трансляции тоже отключает его.

Программа для трансляции (chesslivo-broadcaster) следит за папкой и отправляет каждый изменившийся файл PGN. Скачайте её на вкладке Ключ отправки кнопкой Скачать инструмент: это один файл на Python, которому нужен Python 3.9 или новее и больше ничего (рядом может быть предложена программа для Windows). В терминале:

1. set CHESSLIVO_KEY=<ключ> (в PowerShell: $env:CHESSLIVO_KEY="<ключ>"; в macOS или Linux: export CHESSLIVO_KEY=<ключ>)
2. python chesslivo_broadcaster.py --folder "C:\DGT\Round 1" --round-url <адрес отправки>
3. Оставьте программу работать на время тура; после последнего хода остановите её сочетанием Ctrl+C.

Программа выводит каждый ответ: сколько партий принято и каждую отклонённую доску с номером и причиной. Она проверяет папку каждые 3 секунды (--interval), отправляет файл только при изменении его содержимого, сама повторяет попытки при обрыве связи и останавливается, если ключ отклонён. Параметры: --combine объединяет все файлы папки в одну отправку (лучше всего при файле на доску: без него каждый изменившийся файл отправляется отдельно с интервалом в 2 секунды), --once отправляет один раз и останавливается. У каждого тура свой адрес отправки: для следующего тура запустите программу снова с его адресом.

Отправка через curl

Отправлять может любая программа: POST-запрос на адрес отправки тура с ключом и PGN в теле.

1. curl -H "Authorization: Bearer KEY" --data-binary @games.pgn URL
2. Замените KEY своим ключом, а URL — адресом отправки тура; в games.pgn лежат партии.

В ответе перечислены партии с ходами или ошибками. «/reset» вместо «/push» удаляет доски тура. Не более 2 МБ и 200 партий за отправку, между двумя отправками в один тур — не менее 2 секунд.

Загрузка вручную

1. На вкладке Загрузить выберите тур.
2. Выберите файл PGN или вставьте PGN в поле и нажмите Отправить.
3. В результате показана каждая партия: принята с ходами или отклонена с причиной.

Сбросить тур удаляет все доски тура, чтобы загрузить их заново начисто; в журнале остаётся запись.

Задержка и скрытие в прямом эфире

На вкладке Настройки:

1. Задержка по умолчанию (секунды): зрители видят каждый ход через столько секунд после его прихода (0 — без задержки, не более 86400 — 24 часа). У тура может быть своя задержка в столбце Задержка (с) на вкладке Туры, а вариант После тура показывает ходы только после завершения тура.
2. Скрывать шкалу оценки и движок, пока идёт партия и Скрывать часы, пока идёт партия: на доске они появляются, как только в партии есть результат.

Задержку применяет сам ChessLivo, поэтому программу можно закрыть сразу после последнего хода.

Журнал

Вкладка Журнал показывает по каждому туру последнюю синхронизацию, число увиденных партий, последнюю проблему и последние 200 событий: чтения, отправки, загрузки и ошибки, каждое с партиями, ходами и сообщением. Отклонённые доски указаны с номером и причиной.

Клубные турниры

Турнир, который вы проводите на клубных страницах ChessLivo, можно транслировать с турнирной таблицей арбитра.

1. На странице клубного турнира нажмите Трансляция (расписание должно быть составлено) или привяжите его позже на вкладке Настройки этой трансляции в разделе Турнир клуба. Привязывает и отвязывает только владелец трансляции; после этого трансляцией могут управлять и владелец, администраторы и арбитры клуба.
2. Туры следуют клубной жеребьёвке: один тур на каждый клубный тур, они добавляются сами, когда составляется тур швейцарской системы. Время начала и задержки вы задаёте на вкладке Туры.
3. Отправляйте доски как обычно. Партия попадает на клубную доску с тем же номером тура и доски, под именами, которые показывает клуб; тур, который ещё не опубликован, не принимает доски, а номер доски, которого нет в туре, отклоняется. Если в PGN указан другой игрок, Журнал пишет «Доска 7: в PGN X, в клубе Y», и партия всё равно показывается.
4. Результат из PGN никогда не сохраняется сам: вкладка Результаты показывает его как «Трансляция сообщает 1-0», а Подтвердить вносит его на странице клубного тура, как результат, введённый там вручную.
5. У зрителей появляются вкладки Турнирная таблица и Жеребьёвка с клубных страниц, а имена ведут на клубные страницы игроков.

Отвязать (вкладка «Настройки») сохраняет туры и доски и удаляет ожидающие результаты.

Вопросы и ответы

• Доска не показывается. В ней нет имени игрока, нечитаемый ход или тег, либо номер доски повторяется. Ответ программы, результат загрузки и Журнал называют доску и причину. Исправьте имена в DGT LiveChess или Swiss-Manager. Тег Round вида «тур.доска» задаёт номер доски.
• Доски перепутались. Нажмите Сбросить тур на вкладке Загрузить и отправьте PGN снова.
• В идущей партии показан результат. Результат берётся из вашего исходного PGN: исправьте его в программе, которая этот PGN записывает.
• Нужно ли держать программу запущенной ради задержки? Нет: задержку применяет ChessLivo; закройте программу после последнего хода.
• Программа пишет, что ключ отклонён. Ключ неверный, создан заново или отозван, либо трансляция завершена: создайте новый ключ на вкладке Ключ отправки и запустите программу снова.
• «Слишком частые отправки». Отправки в один тур должны идти с интервалом не менее 2 секунд; программа ждёт сама.
• Моя трансляция скрыта. Её скрыл модератор: её видите только вы, и она не принимает партии, пока её снова не покажут.

Ограничения

• 3 запланированные или идущие трансляции на аккаунт.
• 64 тура на трансляцию, 200 досок в туре.
• За одну отправку: 2 МБ и 200 партий, не чаще одного раза в 2 секунды на тур.
• Задержка: от 0 до 86400 секунд.