Twitch
コミュニティの配信開始を告知します。独自メッセージ、ゲームの絞り込み、配信中ロールも設定できます。
主な機能
配信開始の告知
登録したTwitchチャンネルを監視し、配信開始を検知すると指定Discordチャンネルへ告知します。
独自の告知メッセージ
標準の埋め込み、またはメンション行と埋め込みを備えた独自メッセージを使えます。配信者名、タイトル、ゲーム、リンクをメッセージに自動で差し込みます。
ゲームの絞り込み
特定のゲームを指定し、関心のあるカテゴリを配信している場合だけ告知できます。
配信中ロール
配信中に告知を投稿する際、指定メンバーへ任意のロールを付け、誰が配信中か分かるようにできます。
おすすめの用途
コミュニティの配信者やパートナーの配信開始を紹介する場合。
分かりやすくブランドに合った投稿で、DiscordからTwitchへ視聴者を案内したい場合。
チャンネルごとのゲーム条件で、関連する配信だけを取り上げたい場合。
仕組み
チャンネルを登録
設定 → Twitch でTwitchチャンネルを追加し、告知先を選びます。登録は独立しているため、同じ配信者を別のサーバーやチャンネルでそれぞれの方法でフォローできます。
配信状態を確認
バックグラウンドで登録チャンネルを短い間隔で確認し、配信開始を検知します。画面を開いたままにする必要はありません。
告知を投稿
配信が始まると標準の埋め込みまたは独自メッセージを投稿し、有効なら配信中ロールを付与します。1回の配信は登録ごとに最大1回告知します。
配信が終了
オフラインになると元の告知を終了状態に編集します。埋め込みを灰色にし、開始時のメンションを取り除くため、古い「配信中」通知ではなく整理された記録が残ります。
独自メッセージでは、配信開始ごとに置き換える次のトークンを使えます。
| トークン | 置き換え先 |
|---|---|
| {{streamerName}} | Twitchの配信者表示名。 |
| {{streamTitle}} | 現在の配信タイトル。 |
| {{streamGame}} | 配信中のゲームまたはカテゴリ。 |
| {{streamUrl}} | 配信者のTwitchチャンネルへのリンク。 |
{{ streamUrl }}はメンション行、埋め込みの説明、タイトル、項目値などの文章内で使えます。URLの直接入力が必要な、埋め込みのリンク専用欄では使えません。
設定チェックリスト
設定 → Twitch でチャンネルを追加し、告知先を選びます。
Noxに「チャンネルを表示」「メッセージを送信」「リンクを埋め込む」があることを確認します。
標準の埋め込みか独自メッセージかを決めます。
必要に応じてゲーム条件、配信中ロール、その付与先メンバーを選びます。
注意事項
各配信は登録ごとに1回告知します。配信中に登録した場合は過去の告知を再送せず、次の確認で現在の配信を検知します。
独自メッセージにはメンション行、埋め込み、または両方の内容が必要です。カテゴリ未設定のゲームトークンなど空になる項目は自動で取り除き、空値で投稿が失敗しないようにします。
ゲーム条件は配信カテゴリと照合します。途中で対象ゲームに切り替えた場合、即時ではなく後の確認で告知します。
チャンネル削除やアクセス喪失で今後配信できない場合は、登録を無効にしてエラーページに記録します。
トラブルシューティング
配信開始の告知がない
登録と告知が有効で、チャンネルが選ばれ、Noxに表示・投稿権限があるか確認してください。新しい配信は即時ではなく、次のバックグラウンド確認で検知します。
投稿に埋め込みがない
トークンだけの独自メッセージでタイトルもゲームも空になった場合は、通常の本文投稿に切り替えます。常に埋め込みが必要なら固定文や別のトークンを加えてください。
配信中ロールが付かない
ロール付与は可能な範囲で行い、告知を妨げません。Noxの最上位ロールより下にあり、「ロールを管理」があるか確認してください。失敗した場合は自動で再試行するのではなく、エラーページに記録します。
登録が自動で無効になった
通常はチャンネル削除やアクセス喪失などの恒久的な配信失敗が原因です。チャンネルや権限を直し、設定から再度有効にしてください。
権限
この機能に Nox が必要とする Discord 権限と、それぞれの用途です。
これらの機能をサーバーに追加
NoxをDiscordに追加し、ダッシュボードでサーバーを設定しましょう。追加を許可する前に、必要な権限を確認してください。