Избранные трансляции.

Избранные трансляции позволяют вашему серверу показывать небольшой каталог других стримов Owncast. У посетителей появляется вкладка Избранное на вашей главной странице со списком серверов, которые вы добавили, с указанием их статуса (в эфире или офлайн). Это даёт людям место, куда пойти, когда вы не ведёте трансляцию, и способ найти связанные стримы.

Участие в «Избранном» требует согласия обеих сторон. Вы выбираете, какие серверы добавлять в избранное, а оператор другого сервера решает, разрешить ли вам это. Два сервера могут взаимно добавлять друг друга, но каждое решение утверждается независимо.

Featured streams require Owncast v0.3.0

Избранные трансляции — совершенно новая функция в Owncast 0.3.0. Если вы наткнулись на ошибку или у вас есть предложение, пожалуйста, откройте issue или поговорите в чате с сообществом.

Прежде чем начать

Избранные трансляции работают поверх той же федерации, которая обеспечивает социальные функции Owncast, поэтому:

• Социальные функции должны быть включены как на вашем сервере, так и на том, который вы хотите добавить.
• Другой сервер также должен быть Owncast и иметь достаточно новую версию, чтобы поддерживать избранные трансляции.
• К нему должен быть доступ по HTTPS на стандартном порту (443). Сервер, опубликованный на нестандартном порту, не может быть добавлен в избранное.

Добавить другой стрим в избранное

1. В боковой панели админки откройте Избранные трансляции.
2. Нажмите Добавить живую трансляцию.
3. Введите адрес сервера, который вы хотите добавить в избранное, например https://otherserver.example.com.
4. Сохранить.

Сервер сразу появляется в вашем списке со статусом Ожидает одобрения, и пока не показывается вашим посетителям. Добавление сервера в избранное отправляет ему запрос, и оператор этого сервера должен одобрить его, прежде чем запись станет видимой. Это предотвращает ситуацию, когда кто‑то добавляет сервер в избранное без его согласия.

Одобрить запрос на добавление вас в избранное

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

Одобрение запроса не связано с вашими обычными подписчиками. Сервер, который добавляет вас в избранное, не появляется в списке ваших подписчиков и не влияет на их число.

Вы можете просмотреть все каталоги, которые в настоящее время добавляют вас, и удалить любой из них на вкладке Добавляющие вас в админке «Подписчики». Удаление одного прекращает отправку ему статуса вашего стрима, поэтому ваша запись исчезает из этого каталога.

Что видят ваши посетители

Как только сервер, который вы добавили в избранное, одобрит запрос, он появится на вкладке Избранное вашей главной страницы:

• Серверы в эфире показывают миниатюру текущей трансляции вместе с её заголовком и поднимаются наверх списка.
• Офлайн‑серверы показывают логотип сервера.
• На каждой карточке отображаются имя сервера и его адрес, а также ссылка на этот сервер, чтобы посетитель мог перейти и посмотреть.

Вкладка обновляется примерно раз в минуту автоматически, поэтому появление или завершение эфира у добавленного сервера отображается без перезагрузки страницы.

Статус сервера отражает то, что действительно происходит на нём:

• Он отображается как «в эфире» примерно в течение минуты после начала трансляции.
• Он возвращается в статус офлайн, как только трансляция заканчивается.
• Если добавленный сервер исчезает без корректного завершения трансляции (например, из‑за сбоя или потери связи), его запись возвращается в статус офлайн примерно через десять минут.

Убрать стрим из избранного

В разделе Избранные трансляции нажмите Удалить из избранного рядом с сервером, который вы больше не хотите показывать. Он удаляется из вашего каталога, и ваши посетители перестают его видеть.

Создайте собственный каталог

Функция «Избранные трансляции» основана на поддержке ActivityPub в Owncast. Если вы предпочитаете создать собственный каталог или агрегатор, отслеживающий живые серверы Owncast, вместо использования встроенной вкладки «Избранное», см. Создание каталога стримов Owncast в справочнике по протоколу ActivityPub.

Для полного исполняемого примера см. репозиторий owncast-directory-example. Это небольшое справочное приложение, которое отслеживает серверы Owncast, определяет, какие из них в эфире, принимает отправки от операторов и обслуживает веб‑страницу со списком. Это исключительно демонстрация концепции и не предназначена для использования в продакшене, но показывает, как использовать API ActivityPub для создания каталога стримов Owncast.