チャットボットで配信の現在のカテゴリを表示する!gameコマンド

ボットが現在のゲーム名を取得する場所

!gameコマンドは通常、パソコンで起動中のアプリケーションではなく、Twitchチャンネルの現在のカテゴリを表示します。配信者は配信管理パネルでゲームやカテゴリを変更し、ボットは組み込み変数またはAPIリクエストを通じてその値を取得します。

Twitchのパネルに前のゲームが残っていたり、「雑談」カテゴリが選択されていたり、フィールドが空だったりすると、ボットは同じ値を出力します。チャットボット自体は画面のゲームを認識しません。プラットフォームや外部の自動化が送信するデータを扱うだけです。

まずTwitchでチャンネルカテゴリを更新する

コマンドを設定する前に、カテゴリをどこで変更するかを確認してください。Creator Dashboardのパネル、配信管理用ソフト、またはボットとの連携経由のいずれかです。重要なのは、視聴者が配信ページで見るチャンネルの最終的なステータスです。

ゲームを変更した後、すべてのサービスで即座に更新されるとは限りません。ボットは最後の値をキャッシュに保持していることがあり、プラットフォームも更新されたデータを遅延して送信します。!gameコマンドでは、配信開始前にカテゴリを変更し、チャットでの応答を別途確認するのがおすすめです。

Nightbotでの!gameコマンド

NightbotでCustom Commandsを開き、!gameコマンドを作成して、Twitch変数を含むメッセージを指定します。現在のチャンネルには通常、次のような応答を使用します:「Сейчас играем в: $(twitch game $(channel))」。

$(channel)変数はコマンドが呼び出されたチャンネルを挿入し、$(twitch game ...)はそのカテゴリを取得します。ボットが複数のチャンネルを管理している場合、この方法は各コマンドにストリーマーのログイン名を手動で入力するよりも便利です。

• Command: !игра
• Message: Сейчас играем в: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: 同じ応答でチャットが埋まらないように遅延を設定します

Nightbotの欠点は、応答ロジックが限られていることです。空のカテゴリ、複数のテキストバリエーション、独自のスケジュールからのデータを追加の回避策なしで処理するのは難しいでしょう。

StreamElementsでのカテゴリ付きコマンド

StreamElementsでは、現在のゲームの変数は通常、コマンドの応答に${game}として追加されます。Chat botセクションで!gameコマンドを作成し、「Текущая игра: ${game}」というテキストを設定します。

保存する前に、視聴者アカウントでチャット内のコマンドを確認してください。ボットが目的のチャンネルに接続されていない場合や、チャンネルカテゴリが更新されていない場合、変数は古い値または空のテキストを返すことがあります。権限と遅延の設定は、同じくコマンドのパラメータ内にあります。

• Command: !игра
• Response: Текущая игра: ${game}
• Permission: Everyone
• Cooldown: チャットの活発さに合わせて調整します

StreamElementsの欠点は、コマンドがサービス自体とTwitchの連携に依存していることです。認証の失敗や同期の遅延が発生した場合、コマンドを変更せずに応答を手動で修正することはできません。

Streamer.botでカテゴリを出力する方法

Streamer.botでは、コマンドをAction経由で構築するのが便利です。Twitchチャンネル情報を取得し、チャットにメッセージを送信するアクションを作成します。チャンネルデータ取得のサブアクションの後、アクションの引数で通常gameNameというゲーム名が利用できます。

Send Messageサブアクションで、例えば「Сейчас играем в: %gameName%」と指定します。次にCommandsセクションでActionを!gameコマンドに紐付けます。使用しているStreamer.botのビルドで引数名が異なる場合は、まずテストモードでアクションを実行し、Twitchサブアクションが返した引数のリストを確認してください。

Streamer.botの欠点は、手動設定が多いことです。コマンド、アクション、ボットのチャットへのアクセス、Twitch認証を自分で連携する必要があるため、どの段階でのエラーでもコマンドが応答しなくなります。

Twitch API経由でのカテゴリ取得

カスタムボット、スクリプト、またはStreamer.botのActionは、Twitch APIを通じて直接カテゴリを取得できます。そのためにはまずチャンネルの数値IDを確認します。リクエストGET https://api.twitch.tv/helix/users?login=チャンネルログイン はidを含むユーザーデータを返します。

次にリクエストGET https://api.twitch.tv/helix/channels?broadcaster_id=チャンネルID を使用します。APIの応答にはgame_nameフィールドがあり、これが現在のカテゴリ名で、!gameへの応答としてチャットに送信できます。

リクエストにはClient-IDとアクセストークン付きのAuthorizationヘッダーが必要です。トークンとアプリケーションIDをコマンドの平文、公開リポジトリ、ブラウザウィジェットに挿入しないでください。これらのデータはボットの設定または環境変数に保存する必要があります。

APIコマンドの設定手順

1. Twitch開発者パネルでアプリケーションを作成し、Client IDを取得します。
2. チャンネルデータへのアクセス権を持つトークンを取得し、ボットまたはスクリプトの設定に保存します。
3. ログイン名でusersエンドポイントを通じてチャンネルのbroadcaster_idを特定します。
4. broadcaster_idを指定してchannelsエンドポイントにリクエストを送信します。
5. 応答からgame_nameフィールドを取得し、チャット用のメッセージを形成します。
6. game_nameが空の場合は、空の応答の代わりにニュートラルなテキストを出力します。

チャットの各メッセージに対してAPIをポーリングしないでください。!gameの最初の呼び出しで値を更新し、コマンドの遅延時間中はそれを保存し、キャッシュの期限切れ後にデータを再取得するのが実用的です。カテゴリを手動で変更した後は、専用のモデレーターコマンドで値を強制的に更新できます。

カテゴリを更新して古い応答を受け取らない方法

配信中にゲームを変更する場合は、まずTwitchでカテゴリを更新し、新しい値がチャンネルページに表示されるまで待ってから、!gameを確認してください。ボットがキャッシュを使用している場合は、キャッシュをクリアするか、次のAPIリクエストを待ちます。

1つのチャンネルでは通常、常時ポーリングを開始するのではなく、コマンド呼び出し時にカテゴリを更新するだけで十分です。自動モニタリングが必要な場合は、適度な間隔でチェックし、APIの制限を考慮してください。頻繁なリクエストはデータを正確にするわけではなく、プラットフォーム側からの制限につながる可能性があります。

直接APIアプローチの欠点は、トークンを監視する必要があることです。アクセスが取り消されたり、パスワードが変更されたり、アプリケーションの権限が変更されたり、認証エラーが発生したりすると、コマンドが古いカテゴリを出力したり、応答しなくなったりする可能性があります。

パソコンでのゲーム認識とその限界

別の認識ツールは、Twitchカテゴリが手動で変更されない場合にのみ必要です。このような自動化は、実行中のプロセス、ゲームプラットフォームのデータ、アクティブウィンドウ、またはテレメトリを追跡し、ゲームをTwitchカテゴリと照合してAPI経由でチャンネルを更新します。

その後もボットは画面の内容ではなく、Twitchカテゴリを読み取ります。自動化はチャンネルデータを代わりに変更するだけです。ゲームがランチャー経由で起動された場合、ブラウザ版が使用された場合、プロセス名がゲームと一致しない場合、またはストリーマーが別のプログラムに切り替えた場合、自動化は誤る可能性があります。

認識の欠点は、個別に設定して管理する必要があることです。複数のゲーム、MOD、エミュレーター、技術的なシーンがある配信では、手動でのカテゴリ変更の方が信頼できることがよくあります。

空のカテゴリ、複数のゲーム、手動テキスト

プラットフォームは現在のカテゴリを1つだけ送信します。配信で複数のゲームがある場合、!gameコマンドは現在進行中のものを表示すべきであり、配信プランは別の!расписаниеコマンドまたはチャンネル説明に記載するのが良いでしょう。

空のカテゴリには、わかりやすい応答を用意してください:「Текущая категория пока не указана」または「Сейчас разговорный эфир」。NightbotとStreamElementsでは、このような処理に別のコマンドまたはテキストの手動変更が必要になる場合があります。カスタムAPIスクリプトでは、game_nameフィールドが空かどうかを確認し、代替オプションを挿入できます。

手動コマンドは有効な予備として残ります:「Сейчас играем в: ゲーム名」。欠点は明らかです。ゲーム変更後に更新を忘れやすく、視聴者は誤った情報を受け取ることになります。

権限、遅延、配信前の確認

メインの!gameコマンドは通常、すべての視聴者が利用できるようにしますが、cooldownを追加します。これにより、複数の人が同時にゲームを尋ねたときに同じメッセージが繰り返されるのを減らせます。キャッシュクリア、テキストの手動更新、Actionの再起動のコマンドはモデレーターとチャンネルオーナーに限定してください。

ボット、トークン、Twitch連携を変更した後はコマンドを確認してください。 正しい変数でも、ボットが別のチャンネルに接続されている場合やデータ読み取り権限を失っている場合は役に立ちません。

1. Twitchパネルで目的のゲームまたはカテゴリを指定します。
2. 新しい名前がチャンネルページに表示されることを確認します。
3. チャットボットが自分のチャンネルに接続されていることを確認します。
4. 通常の視聴者アカウントで!gameを呼び出します。
5. カテゴリを変更し、キャッシュの更新またはコマンドの遅延後に再度呼び出します。
6. 空のカテゴリ時と雑談配信中の応答を確認します。
7. APIを使用している場合は、トークンの有効期限とリクエストエラーログを確認します。