YouTube
Входит в Macro DeckПоказывайте чат и статистику прямой трансляции YouTube, меняйте название и теги и реагируйте на Super Chat и новых спонсоров.
Виджет «Чат YouTube» и виджеты «Статистика трансляции YouTube»
- Виджеты «Чат YouTube» и «Статистика трансляции YouTube»
- Название, описание и теги трансляции
- Начало и завершение трансляции и рекламные паузы
- Триггеры для Super Chat, Super Sticker и спонсорства
- Собственный проект Google Cloud и собственная квота
Интеграция YouTube подключает ваш канал YouTube к Macro Deck. Она показывает состояние прямой трансляции в переменных, запускает триггеры для Super Chat, Super Sticker и спонсорства, выводит чат трансляции в виджет, где его можно модерировать, и меняет трансляцию одной кнопкой.
YouTube не предлагает общий вход, который Macro Deck мог бы использовать для всех. Вы подключаетесь через собственный проект Google Cloud: это делается один раз и занимает около десяти минут. Проект бесплатный, а его квота и разрешения принадлежат только вам.
Что можно делать
- Отправлять сообщения в чат текущей трансляции.
- Менять название, описание или теги идущей трансляции, а если вы не в эфире, то следующей запланированной.
- Запускать следующую запланированную трансляцию с помощью действия Начать трансляцию, завершать её действием Завершить трансляцию и запрашивать у YouTube рекламную паузу.
- Показывать чат трансляции в виджете Чат YouTube и удалять из него сообщения, выдавать таймауты или банить участников.
- Показывать, идёт ли эфир, число зрителей, лайков и подписчиков, название и время в эфире в виджете Статистика трансляции YouTube.
Несколько примеров:
- Кнопка Выходим в эфир, которая задаёт название и теги следующей трансляции.
- Кнопка Реклама, которая запрашивает у YouTube рекламную паузу на 60 секунд.
- Цепочка действий, которая запускается по триггеру Super Chat и показывает уведомление с автором и суммой.
- Цепочка действий, которая запускается по триггеру Новый участник и публикует в чате сообщение с благодарностью.
Как это работает
Пока вы в эфире, Macro Deck считывает состояние трансляции примерно раз в минуту, а чат каждые несколько секунд. Каждое чтение и каждое изменение расходует квоту вашего проекта Google Cloud, которая составляет 10 000 единиц в день. Macro Deck ведёт подсчёт. Когда квота почти исчерпана, он приостанавливает обновление чата и реже считывает статус эфира. Когда квота исчерпана, он приостанавливает обновление статуса эфира и чата до полуночи по тихоокеанскому времени, когда Google сбрасывает квоту.
Чат, Super Chat и события спонсорства приходят только во время прямой трансляции. События, которые произошли, пока Macro Deck не работал, позже не запускаются. Можно подключить несколько каналов: у каждого действия есть поле Канал, а каждый триггер можно ограничить одним каналом.
Что понадобится
- Macro Deck 3 в Windows, macOS или Linux с доступом в интернет
- Канал YouTube, на котором можно проводить прямые трансляции
- Проект Google Cloud с включённым YouTube Data API v3
- Идентификатор клиента OAuth типа TVs and Limited Input devices с его секретом клиента
- Для «Начать рекламную паузу» нужна прямая трансляция на канале, который может показывать рекламу в середине видео
Настройка
Шаг 1: Создайте проект Google Cloud
Откройте консоль Google Cloud под аккаунтом Google, которому принадлежит канал, и создайте проект, например Macro Deck. В разделе APIs & Services > Library найдите YouTube Data API v3 и нажмите Enable.
Шаг 2: Настройте экран согласия
Откройте APIs & Services > OAuth consent screen (в новых версиях консоли Google Auth Platform). Выберите External, введите название приложения и свой адрес электронной почты и сохраните. В разделе Audience (или Test users) добавьте аккаунт Google, которому принадлежит канал, в качестве тестового пользователя.
Шаг 3: Создайте идентификатор клиента OAuth
Откройте APIs & Services > Credentials, нажмите Create credentials > OAuth client ID и выберите тип приложения TVs and Limited Input devices. Любой другой тип будет отклонён при входе. Скопируйте Идентификатор клиента и Секрет клиента, которые покажет Google.
Шаг 4: Введите данные клиента в Macro Deck
В Macro Deck нажмите Интеграции на боковой панели и выберите YouTube. На вкладке Обзор нажмите Добавить настройку в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог, а интеграция включится после завершения настройки. В диалоге Подключение канала YouTube вставьте Идентификатор клиента и Секрет клиента. Только если Google выделил вашему проекту больше квоты, включите переключатель Дополнительная настройка и укажите её в поле Дневная квота (единицы). Нажмите Продолжить.
Шаг 5: Подтвердите доступ в Google
Теперь диалог показывает шаг Подтвердите доступ в Google с полем Код устройства. Нажмите Открыть Google и подтвердить, войдите в аккаунт, которому принадлежит канал, введите код, выберите канал и разрешите доступ. Google предупредит, что приложение не проверено: это ваш собственный проект, поэтому продолжайте. Вернитесь в Macro Deck и нажмите Продолжить. Настройка получит название по вашему каналу, например YouTube (My Channel). Когда диалог покажет Настройка завершена., нажмите Готово.
Шаг 6: Добавьте действие YouTube на кнопку
На странице Панель нажмите на кнопку, которую хотите использовать. Панель должна быть разблокирована: если кнопка в правом верхнем углу называется Заблокировать, панель разблокирована. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите YouTube и затем действие, например Задать название трансляции. Выберите Канал, введите текст в поле Название и нажмите Сохранить.
Действия7
Назначьте их на кнопку или запускайте из цепочки действий.
- Отправить сообщение в чат
- Публикует сообщение длиной до 200 символов в чате текущей трансляции.
- Задать название трансляции
- Меняет название текущей трансляции, а если вы не в эфире, то следующей запланированной.
- Задать описание трансляции
- Меняет описание текущей или следующей запланированной трансляции.
- Задать теги трансляции
- Заменяет теги текущей или следующей запланированной трансляции.
- Начать рекламную паузу
- Просит YouTube показать во время прямой трансляции рекламную паузу длительностью от 30 секунд до 3 минут.
- Начать трансляцию
- Запускает следующую запланированную трансляцию, которая готова к началу. Сначала запустите программу для трансляции.
- Завершить трансляцию
- Завершает текущую прямую трансляцию.
Триггеры8
Кнопка или цепочка действий может реагировать на эти события.
- Трансляция начата
- Канал вышел в эфир.
- Трансляция завершена
- Прямая трансляция канала завершилась.
- Super Chat
- Кто-то отправил Super Chat, с автором, суммой, валютой и комментарием.
- Super Sticker
- Кто-то отправил Super Sticker.
- Новый участник
- Кто-то стал спонсором канала или повысил уровень спонсорства.
- Веха участника
- Спонсор поделился в чате этапом своего спонсорства.
- Подаренные членства
- Кто-то подарил спонсорство другим зрителям.
- Событие YouTube (расширенное)
- Все события YouTube из этого списка в одном триггере, при желании с фильтром по типу.
Переменные8
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
youtube_<channel>_display_name- Название канала.
youtube_<channel>_is_live- Находится ли канал в эфире.
youtube_<channel>_stream_title- Название прямой трансляции.
youtube_<channel>_viewer_count- Текущее число зрителей. Пусто, если вы скрываете число зрителей.
youtube_<channel>_like_count- Лайки прямой трансляции.
youtube_<channel>_subscriber_count- Подписчики канала с округлением, как его делает YouTube.
youtube_<channel>_uptime_seconds- Сколько длится трансляция, в секундах.
youtube_<channel>_stream_thumbnail_url- Миниатюра трансляции.
Виджеты2
Добавляйте их на свою панель в окне выбора виджета.
- Чат YouTube
- Показывает чат текущей трансляции, включая Super Chat и новых спонсоров. Нажмите на него, чтобы модерировать в диалоге покрупнее.
- Статистика трансляции YouTube
- Показывает статус эфира, зрителей, лайки и подписчиков, название и время в эфире в выбранном стиле.
Часто задаваемые вопросы
Зачем нужен собственный проект Google Cloud?
YouTube не предлагает общий вход, который Macro Deck мог бы использовать для всех. С собственным проектом квота и разрешения принадлежат только вам. Проект бесплатный.
Почему нужно входить снова каждую неделю?
Пока экран согласия вашего проекта находится в режиме тестирования, Google завершает вход через 7 дней. Тогда в разделе Интеграции будет указано, что вход истёк: подключитесь заново с тем же идентификатором и секретом клиента. Чтобы оставаться в системе, опубликуйте экран согласия в консоли Google Cloud.
Что происходит, когда квота заканчивается?
Macro Deck приостанавливает обновление статуса эфира и чата, а на странице YouTube в разделе Интеграции появляется сообщение Квота YouTube исчерпана. Google сбрасывает квоту в полночь по тихоокеанскому времени, и тогда обновления возобновляются. Действия продолжают работать, пока Google их не отклонит.
Почему «Начать трансляцию» не запускает мой эфир?
Действие Начать трансляцию запускает следующую запланированную трансляцию, поток которой уже поступает на YouTube, поэтому сначала запустите программу для трансляции. Трансляции, которые начинаются автоматически, а также Stream now в YouTube Studio запускает YouTube, а не это действие.
Можно ли разбанить кого-то из виджета чата?
Только тех, кого вы забанили через Macro Deck во время текущей трансляции, и только до перезапуска Macro Deck. YouTube не сообщает Macro Deck, какие баны существуют, поэтому остальные баны снимайте в YouTube Studio.
Где хранятся мои данные для входа?
Секрет клиента и токены хранятся в зашифрованном виде на компьютере, где работает Macro Deck, и отправляются только в Google.
Ещё в группе «Трансляции»
OBS Studio
Входит в Macro DeckПереключайте сцены, управляйте трансляцией, записью и звуком и реагируйте на то, что происходит в OBS Studio.
Meld Studio
Входит в Macro DeckПереключайте и подготавливайте сцены, управляйте слоями, эффектами и аудиодорожками и выходите в эфир в Meld Studio.
Streamlabs Desktop
Входит в Macro DeckПереключайте сцены, управляйте трансляцией, записью и источниками звука в Streamlabs Desktop.
Streamer.bot
Входит в Macro DeckЗапускайте действия Streamer.bot, отправляйте сообщения в чат и реагируйте на любое событие, о котором сообщает Streamer.bot.
Twitch
Входит в Macro DeckПоказывайте чат и статистику трансляции Twitch, модерируйте, проводите опросы и запускайте рекламу, реагируйте на фолловы, подписки и рейды.