AudD для стримеров на Twitch

Если вы ведете стримы с музыкой — диджей-сеты, «общение» с музыкой на фоне или радио-канал — AudD может сообщать вам и вашим зрителям, что играет в режиме реального времени, и вести запись этого. Эта страница предназначена для стримеров Twitch и тех, кто создает для них оверлеи и ботов. Вы указываете AudD на свой канал, сервис распознает песни из живого аудио по мере их воспроизведения, а вы получаете каждое совпадение на свой бэкенд для отображения, логирования или того и другого.

AudD — это HTTP API для распознавания музыки, работающее на базе данных из 160 миллионов песен. Его API аудиопотоков непрерывно принимает живой поток и создает «цифровые отпечатки» аудио, поэтому вам не нужно ничего захватывать или загружать самостоятельно — вы регистрируете канал один раз и получаете результаты совпадений.

Что вы можете сделать

Две вещи, которые обычно хотят стримеры от распознавания музыки, — это отображение («что это за песня?») и запись («что я проигрывал во время этого VOD?»). И то, и другое обеспечивается одной и той же подпиской на поток.

• Показывайте зрителям текущую песню. AudD распознает песни из вашего живого аудио и передает каждое совпадение — исполнителя, название, альбом, ссылку на песню — чтобы оверлей или панель могли отобразить «сейчас играет». Передайте параметр callbacks=before, и совпадение придет в тот момент, когда песня только начинается, что и требуется для живого отображения.

Показывайте зрителям текущую песню. AudD распознает песни из вашего живого аудио и передает каждое совпадение — исполнителя, название, альбом, ссылку на песню — чтобы оверлей или панель могли отобразить «сейчас играет». Передайте параметр callbacks=before, и совпадение придет в тот момент, когда песня только начинается, что и требуется для живого отображения.

• Направьте AudD прямо на свой канал с помощью ярлыка. Вам не нужно искать прямой URL медиапотока. API потоков принимает ярлык twitch:<channel> в качестве URL потока — AudD распознает и принимает живое аудио канала. (Он также поддерживает youtube:<video_id>, youtube-ch:<channel_id> и прямые URL HLS / Icecast / m3u8, если вы стримите где-то еще.)

Направьте AudD прямо на свой канал с помощью ярлыка. Вам не нужно искать прямой URL медиапотока. API потоков принимает ярлык twitch:<channel> в качестве URL потока — AudD распознает и принимает живое аудио канала. (Он также поддерживает youtube:<video_id>, youtube-ch:<channel_id> и прямые URL HLS / Icecast / m3u8, если вы стримите где-то еще.)

• Ведите журнал каждой проигранной песни. Каждое совпадение содержит временную метку и, при использовании стандартного обратного вызова (после песни), длительность воспроизведения. Сохраняйте их, и у вас будет журнал с временными метками того, что играло во время сессии — история «недавно проигранных» для зрителей и лог, который можно просмотреть позже.

Ведите журнал каждой проигранной песни. Каждое совпадение содержит временную метку и, при использовании стандартного обратного вызова (после песни), длительность воспроизведения. Сохраняйте их, и у вас будет журнал с временными метками того, что играло во время сессии — история «недавно проигранных» для зрителей и лог, который можно просмотреть позже.

• Проверяйте свои сеты на соответствие музыкальной политике. Многих стримеров беспокоит отключение звука в VOD и страйки на канале, когда в запись попадают защищенные авторским правом треки. Журнал воспроизведения фактически показывает, какие записи были в конкретном стриме и когда — так вы сможете найти трек, который не хотели бы использовать, и отредактировать или заглушить этот сегмент VOD, прежде чем возникнут проблемы. AudD определяет, что играло; что с этим делать — решать вам (это не юридическая консультация).

Проверяйте свои сеты на соответствие музыкальной политике. Многих стримеров беспокоит отключение звука в VOD и страйки на канале, когда в запись попадают защищенные авторским правом треки. Журнал воспроизведения фактически показывает, какие записи были в конкретном стриме и когда — так вы сможете найти трек, который не хотели бы использовать, и отредактировать или заглушить этот сегмент VOD, прежде чем возникнут проблемы. AudD определяет, что играло; что с этим делать — решать вам (это не юридическая консультация).

• Управляйте оверлеем без написания фронтенда. AudD предоставляет встраиваемый виджет по адресу widget.audd.tech, который отображает последнюю распознанную песню (и, опционально, историю) напрямую из подписки на поток. Добавьте его в качестве браузерного источника в OBS или создайте свой собственный оверлей, работающий с вашим бэкендом.

Управляйте оверлеем без написания фронтенда. AudD предоставляет встраиваемый виджет по адресу widget.audd.tech, который отображает последнюю распознанную песню (и, опционально, историю) напрямую из подписки на поток. Добавьте его в качестве браузерного источника в OBS или создайте свой собственный оверлей, работающий с вашим бэкендом.

• Получайте совпадения независимо от того, есть ли у вас сервер. AudD отправляет обратный вызов (callback) на URL, который вы хостите (рекомендуемый путь), или вы можете держать открытым соединение longpoll, если не можете открыть публичный URL — например, на ноутбуке за NAT или в браузере. Выбирайте то, что лучше подходит для вашей настройки.

Получайте совпадения независимо от того, есть ли у вас сервер. AudD отправляет обратный вызов (callback) на URL, который вы хостите (рекомендуемый путь), или вы можете держать открытым соединение longpoll, если не можете открыть публичный URL — например, на ноутбуке за NAT или в браузере. Выбирайте то, что лучше подходит для вашей настройки.

Для API потоков нужен ваш реальный токен, а не тестовый. Аудиопотоки — это платное дополнение; публичный тестовый токен работает только со стандартной точкой распознавания, а не с потоками. Получите свой токен на dashboard.audd.io.

Для API потоков нужен ваш реальный токен, а не тестовый. Аудиопотоки — это платное дополнение; публичный тестовый токен работает только со стандартной точкой распознавания, а не с потоками. Получите свой токен на dashboard.audd.io.

С чего начать

• «Создание виджета «сейчас играет» для прямого эфира» — это комплексное руководство: установите URL обратного вызова для аккаунта, добавьте свой поток, получайте совпадения через callback или longpoll и добавьте готовый HTML/JS оверлей для OBS. Он использует ярлык twitch:<channel> и трюк с обложкой ?thumb.

«Создание виджета «сейчас играет» для прямого эфира» — это комплексное руководство: установите URL обратного вызова для аккаунта, добавьте свой поток, получайте совпадения через callback или longpoll и добавьте готовый HTML/JS оверлей для OBS. Он использует ярлык twitch:<channel> и трюк с обложкой ?thumb.

• «Отображение распознанной музыки на стриме Twitch» фокусируется именно на стороне Twitch — подписке на канал и отображении совпадений в оверлее или панели расширения Twitch.

«Отображение распознанной музыки на стриме Twitch» фокусируется именно на стороне Twitch — подписке на канал и отображении совпадений в оверлее или панели расширения Twitch.

• «Callbacks против longpoll» объясняет два способа получения совпадений и как выбрать подходящий: хостинг вебхука или поддержание открытого соединения, и почему в любом случае для аккаунта должен быть задан URL обратного вызова.

«Callbacks против longpoll» объясняет два способа получения совпадений и как выбрать подходящий: хостинг вебхука или поддержание открытого соединения, и почему в любом случае для аккаунта должен быть задан URL обратного вызова.

• «Публичная база данных против вашего собственного каталога» описывает, с чем сравнивает AudD — публичная база данных из 160 млн треков против вашего личного каталога треков — это актуально, если вы стримите собственную музыку.

«Публичная база данных против вашего собственного каталога» описывает, с чем сравнивает AudD — публичная база данных из 160 млн треков против вашего личного каталога треков — это актуально, если вы стримите собственную музыку.

Пример кода

Это регистрирует ваш канал Twitch в AudD с помощью ярлыка twitch:<channel> и запрашивает совпадения в начале песни, чтобы отображение текущего трека обновлялось мгновенно при его запуске. Сначала один раз установите URL обратного вызова учетной записи; см. рецепт для принимающего сервера.

После добавления потока AudD отправляет POST-запрос с совпадением на ваш URL обратного вызова каждый раз, когда начинается песня. В теле запроса указывается название записи и ссылка на нее на lis.tn; добавление ?thumb к этой song_link дает вам изображение обложки для оверлея:

Кэшируйте последнее совпадение для каждого radio_id для вашего оверлея и добавляйте каждое совпадение в список для вашего журнала воспроизведения. Рецепт виджета «сейчас играет» содержит полный приемник обратных вызовов, альтернативу longpoll и готовый для копирования оверлей OBS.

Обратный вызов «до» (before) не имеет параметра play_length. AudD сообщает общее время воспроизведения только после завершения песни, поэтому обратный вызов по умолчанию (после песни) содержит play_length, а «до» — нет. Для отображения в реальном времени это нормально; для точного журнала длительности воспроизведения используйте время обратного вызова по умолчанию.

Обратный вызов «до» (before) не имеет параметра play_length. AudD сообщает общее время воспроизведения только после завершения песни, поэтому обратный вызов по умолчанию (после песни) содержит play_length, а «до» — нет. Для отображения в реальном времени это нормально; для точного журнала длительности воспроизведения используйте время обратного вызова по умолчанию.

• Сканирование архива ваших трансляций (VOD и клипов) на наличие музыки, защищенной авторским правом
• AudD для платформ прямых трансляций
• Создание виджета «сейчас играет» для прямой трансляции
• Отображение распознанной музыки в трансляции Twitch
• Обратные вызовы против longpoll
• Публичная база данных против вашего пользовательского каталога
• Справочник по API потоков