Twitch
Macro Deck に同梱Twitch のチャットと配信統計を表示し、モデレーション、投票、広告を行い、フォロー、サブスク、レイドに反応します。
Twitch チャットウィジェットと、視聴者数、チャット参加者数、フォロワー数を表示する Twitch 配信統計ウィジェット
- Twitch チャットと Twitch 配信統計のウィジェット
- タイトルとカテゴリーの設定、広告の実行、レイドの開始、クリップの作成
- ボタンから投票、予想、シャウトアウト、チャットモード
- フォロー、サブスク、チア、レイド、引き換えで動くトリガー
- 複数の Twitch アカウントを接続
Twitch 連携は、1 つ以上の Twitch アカウントを Macro Deck に接続します。短いコードで Twitch にサインインすると、Macro Deck はチャンネルのイベントをリアルタイムで受け取り、そのアカウントとしてチャンネルを操作できるようになります。
できること
- 配信のタイトル、カテゴリー、タグを変更する、チャットメッセージやお知らせを送る、シャウトアウトを送る。
- 広告を実行する、次の広告を延期する、レイドを開始またはキャンセルする、クリップやストリームマーカーを作成する。
- 投票と予想を開始、終了する、チャンネルポイントの引き換えを完了または返却にする。
- モデレーション: ユーザーを BAN またはタイムアウトする、BAN を解除する、メッセージを削除する、チャットをクリアする、エモート限定、フォロワー限定、スロー、サブスクライバー限定、ユニークチャットをオンまたはオフにする。
- Twitch チャット ウィジェットで、エモートやバッジ付きのチャットを表示し、そこからモデレーションする。
- Twitch 配信統計 ウィジェットで、配信状態、視聴者、チャット参加者、フォロワー、サブスクライバー、タイトル、カテゴリー、配信時間を表示する。
設定例:
- タイトルとカテゴリーを設定してお知らせを送る まもなく開始 ボタン。
- 90 秒の広告を流す 広告 ボタン。
- クリップを作成し、その編集用 URL を変数に書き込む クリップ ボタン。
- 特定のリワードの チャンネルポイントのリワード引き換え で OBS のシーンを切り替えるフロー。
- レイドを受けた で、レイドしてくれた配信者にシャウトアウトを送るフロー。
動作のしくみ
Macro Deck は接続した各アカウントの Twitch イベントを購読するので、新しいフォロワー、チア、レイドを受けた などのトリガーはすぐに動作します。視聴者数などの配信の値は 30 秒ごとに Twitch から読み取ります。すべての値は twitch_<account>_<value> という名前の変数 (例: twitch_mychannel_viewer_count) として使えるので、自分のウィジェットや条件に利用できます。
複数の Twitch アカウントを接続できます。すべてのアクションに アカウント 欄があり、すべてのトリガーを 1 つのアカウントに限定できます。Macro Deck が求める権限の一部を Twitch が付与しなかった場合、連携 に動作しないイベントの一覧が表示され、再接続を勧められます。Twitch との接続が切れると、Macro Deck は自動で再接続します。Macro Deck でアカウントを 30 日間使わなかった場合や、Twitch で Macro Deck のアクセスを取り消した場合はサインインが期限切れになり、連携 でアカウントを接続し直すよう求められます。
必要なもの
- インターネットに接続できる Windows、macOS、Linux 上の Macro Deck 3
- Twitch アカウント
- 「広告を実行」には、配信中のアフィリエイトまたはパートナーのチャンネルが必要
- クリップとストリームマーカーは、チャンネルの配信中のみ動作
セットアップ
ステップ 1: Macro Deck で Twitch を開く
Macro Deck のサイドバーで 連携 をクリックし、Twitch をクリックします。概要 タブの 設定 セクションで 設定を追加 をクリックします。右上のスイッチをオンにしても同じダイアログが開き、セットアップが完了すると連携が有効になります。
ステップ 2: Twitch でアクセスを承認する
Twitch アカウントを接続 ダイアログに デバイスコード が表示されます。Twitch を開いて承認 をクリックすると、コードが入力された状態でブラウザに Twitch が開きます。接続したいアカウントでサインインし、アクセスを承認します。
自分で登録した Twitch アプリケーションを使うには、詳細な設定 をオンにして、独自のクライアント ID(詳細設定) にそのクライアント ID を入力します。Macro Deck 自身のアプリケーションを使う場合は、この欄を空欄のままにします。
ステップ 3: セットアップを完了する
Macro Deck に戻り、続行 をクリックします。Macro Deck は設定に、Twitch (mychannel) のようにアカウントにちなんだ名前を付けます。ダイアログに セットアップが完了しました。 と表示されたら、完了 をクリックします。
ステップ 4: ボタンに Twitch のアクションを追加する
デッキ ページで、使いたいボタンをクリックします。デッキのロックが解除されている必要があります。右上のボタンに ロック と表示されていれば解除されています。エディターが開き、短押し が選択されています。+ アクションを追加 をクリックし、アクションを追加 ダイアログの左側で Twitch を選択して、チャットメッセージを送信 などのアクションを選びます。アカウント を選び、メッセージ を入力して、保存 をクリックします。
ステップ 5: ボタンを押す
スマートフォン、タブレット、または Web クライアントでボタンを押します。Twitch のチャットにメッセージが表示されます。デッキでチャットを見るには、Twitch チャット ウィジェットを追加します。
アクション20
ボタンに設定したり、フローから実行したりできます。
- タイトルとカテゴリーを設定
- 配信のタイトル、カテゴリー、タグを変更します。空欄の項目は変更されません。
- チャットメッセージを送信
- 接続したアカウントとしてチャンネルのチャットにメッセージを送ります。返信として送ることもできます。
- お知らせを送信
- 選んだ色で、チャットに目立つお知らせを投稿します。
- シャウトアウトを送信
- 別のチャンネルにシャウトアウトを送ります。Twitch では 2 分に 1 回まで送れます。
- チャットをクリア
- チャンネルのチャットからすべてのメッセージを削除します。
- チャットメッセージを削除
- チャットからメッセージを 1 つ削除します。
- チャットモードを設定
- エモート限定、フォロワー限定、スロー、サブスクライバー限定、ユニークチャットをオン、オフ、または切り替えます。
- 広告を実行
- 30 秒から 3 分の広告を開始します。
- 次の広告を延期
- 次に予定されている広告を 5 分後に延期します。
- レイドを開始
- チャンネルの視聴者を別のチャンネルに送ります。
- レイドをキャンセル
- まだ実行されていないレイドを中止します。
- クリップを作成
- 配信の直前 30 秒をクリップにし、クリップの編集用 URL を変数に書き込めます。
- ストリームマーカーを作成
- 後で編集するために、配信の現在の位置に印を付けます。
- BAN またはタイムアウト
- 視聴者を BAN します。時間を指定するとタイムアウトにします。
- BAN を解除
- BAN またはタイムアウトを解除します。
- 投票を作成
- 2 から 5 個の選択肢で投票を開始します。
- 投票を終了
- 現在実施中の投票を終了します。
- 予想を作成
- 2 から 10 個の結果でチャンネルポイントの予想を開始します。
- 予想を終了
- 現在実施中の予想を確定、締め切り、またはキャンセルします。
- 報酬の引き換えを処理
- チャンネルポイントの引き換えを完了にするか、返却します (同じ Twitch アプリケーションで作成したリワードのみ)。
トリガー39
ボタンやフローがこれらのイベントに反応できます。
- 配信オンライン
- チャンネルが配信を開始しました。
- 配信オフライン
- チャンネルが配信を終了しました。
- チャンネル情報が更新されました
- タイトル、カテゴリー、言語、コンテンツ分類ラベルが変わりました。
- 広告枠が開始されました
- チャンネルで広告が始まりました。
- 新しいフォロワー
- 誰かがチャンネルをフォローしました。
- 新しいサブスクリプション
- 誰かがチャンネルをサブスクライブしました。特定のティアだけに限定することもできます。
- 再サブスクライブ
- 誰かがチャットで再サブスクライブを告知しました。
- ギフトサブスクリプション
- 誰かがチャンネルにサブスクリプションをギフトしました。
- サブスクリプションの終了
- チャンネルへのサブスクリプションが期限切れになりました。
- チア
- 誰かがチャンネルで Bits をチアしました。
- レイドを受けた
- 別のチャンネルがこのチャンネルにレイドしました。
- レイドを送った
- このチャンネルが別のチャンネルにレイドしました。
- シャウトアウトの受信
- 別のチャンネルがこのチャンネルにシャウトアウトを送りました。
- シャウトアウトの送信
- チャンネルがシャウトアウトを送りました。
- チャンネルポイントのリワード引き換え
- 視聴者がチャンネルポイントのリワードを引き換えました。特定のリワードだけに限定することもできます。
- 自動報酬が引き換えられました
- 視聴者が Twitch に組み込まれたチャンネルポイントのリワードを使いました。
- 引き換えの処理完了
- チャンネルポイントの引き換えが承認または返却されました。
- 投票の開始
- チャンネルで投票が始まりました。
- 投票の終了
- チャンネルの投票が終わりました。
- 予測の開始
- チャンネルで予想が始まりました。
- 予測の締め切り
- 予想の受け付けが締め切られました。
- 予測の終了
- 予想が確定またはキャンセルされました。
- ハイプトレインの開始
- チャンネルでハイプトレインが始まりました。
- ハイプトレインの進捗
- チャンネルのハイプトレインが進みました。
- ハイプトレインの終了
- チャンネルのハイプトレインが終わりました。
- 目標の開始
- クリエイター目標が始まりました。
- 目標の進捗
- クリエイター目標が進みました。
- 目標の終了
- クリエイター目標が終わりました。
- チャット通知
- サブスク、再サブスク、ギフト、レイド、お知らせ、チャリティーのチャット内通知です。特定の種類だけに限定することもできます。
- チャットがクリアされました
- チャンネルのチャットがクリアされました。
- チャットメッセージが削除されました
- チャットメッセージが 1 つ削除されました。
- チャットモードが変更されました
- エモート限定、フォロワー限定、スロー、サブスクライバー限定、ユニークチャットが切り替わりました。
- ユーザーが BAN またはタイムアウトされました
- 視聴者が BAN またはタイムアウトされました。
- ユーザーの BAN 解除
- 視聴者の BAN が解除されました。
- VIP の追加
- 視聴者に VIP ステータスが付与されました。
- VIP の削除
- 視聴者の VIP ステータスがなくなりました。
- Twitch イベント(詳細)
- Macro Deck がまだ対応していないものも含め、すべての Twitch イベントを生のペイロード付きで受け取ります。
- 接続済み
- Macro Deck がアカウントを Twitch に接続しました。
- 切断
- Twitch との接続が切れました。
変数10
これらの値をボタンやウィジェットに表示したり、条件に使ったりできます。
twitch_<account>_is_connected- アカウントが Twitch に接続しているかどうかです。
twitch_<account>_is_live- チャンネルが配信中かどうかです。
twitch_<account>_stream_title,twitch_<account>_stream_category- 現在のタイトルとカテゴリーです。
twitch_<account>_viewer_count,twitch_<account>_uptime_seconds- 視聴者数と、配信の経過時間 (秒) です。
twitch_<account>_follower_count,twitch_<account>_subscriber_count,twitch_<account>_subscriber_points- チャンネルのフォロワー、サブスクライバー、サブスクライバーポイントの合計です。
twitch_<account>_chatter_count- 自分やボットを含む、チャットにいる全員の数です。
twitch_<account>_stream_thumbnail_url- 現在の配信のサムネイルの URL です。
twitch_<account>_display_name,twitch_<account>_login- アカウントの表示名とログイン名です。
twitch_<account>_emote_only,twitch_<account>_followers_only,twitch_<account>_followers_only_duration,twitch_<account>_slow_mode,twitch_<account>_slow_mode_wait_time,twitch_<account>_subscriber_only,twitch_<account>_unique_chat- チャットモードです。エモート限定、フォロワー限定とその時間 (分)、スローモードとその待ち時間 (秒)、サブスクライバー限定、ユニークチャットです。
twitch_<account>_last_follower,twitch_<account>_last_subscriber,twitch_<account>_last_cheerer,twitch_<account>_last_raider- 最新のフォロワー、サブスクライバー、Bits を送ったユーザー、レイドしたユーザーです。
ウィジェット2
ウィジェットの選択画面からデッキに追加できます。
- Twitch チャット
- チャンネルのチャットをエモートとバッジ付きで表示します。押すと大きなチャットが開き、メッセージの削除、タイムアウト、BAN ができます。
- Twitch 配信統計
- 配信状態、視聴者、チャット参加者、フォロワー、サブスクライバー、タイトル、カテゴリー、配信時間を、選んだスタイルで表示します。
よくある質問
複数の Twitch アカウントを接続できますか?
はい。もう一度 設定を追加 をクリックし、別のアカウントで承認します。各アクションには アカウント 欄があり、変数にはアカウント名が付きます (例: twitch_mychannel_is_live)。
もう一度サインインする必要があるのはなぜですか?
Twitch は、30 日間使われなかった場合や、Twitch で Macro Deck のアクセスを取り消した場合にサインインを終了します。その場合、連携 にサインインが期限切れになったと表示されます。再接続 でアクセスをもう一度承認してください。
アクションが失敗するのはなぜですか?
多くのアクションは特定の状況でのみ動作します。クリップを作成 と ストリームマーカーを作成 はチャンネルの配信中のみ、広告を実行 は配信中のアフィリエイトまたはパートナーのチャンネルのみ、シャウトアウトを送信 は 2 分に 1 回だけ動作します。Twitch が権限を付与しなかった場合は、アカウントを接続し直して権限を付与してください。
既存のリワードの引き換えを処理できないのはなぜですか?
Twitch では、アプリケーションが処理できるのは、同じアプリケーションで作成したリワードの引き換えだけです。Twitch のダッシュボードで作成したリワードは、API では処理できません。
チャットウィジェットからモデレーションできるのは誰ですか?
デッキを使える人なら誰でもできます。チャットを表示するだけにするには、ウィジェットの設定で チャットダイアログでモデレーションを許可 をオフにしてください。
Twitch のトークンはどこに保存されますか?
Macro Deck は、アクセストークンとリフレッシュトークンを、Macro Deck を実行しているコンピューター上に暗号化して保存します。Twitch のパスワードを Macro Deck に入力することはなく、アクセスは Twitch 上で承認します。
配信のその他の連携
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 が報告するすべてのイベントに反応します。
YouTube
Macro Deck に同梱YouTube のライブチャットと配信統計を表示し、タイトルやタグを変更して、スーパーチャットやメンバーに反応します。