3. プラットフォーム API ノードとの接続
このステップでやること: 配信プラットフォームのチャット・投げ銭受信ノードを MARS イベント入力ノードに接続し、実際のチャット !Throw でリアクションが実行されるようにします。
必要なもの
- ステップ 2 まで完了したシーン(ルール
Throwが有効) - 使用するプラットフォームの連携プラグインとログイン
- チジク: ワークショップ CHZZK プラグイン
- SOOP: ワークショップ SOOP プラグイン
- Twitch: Warudo 標準機能(Settings → Twitch で接続)
手順
- ブループリントタブで + から新しいブループリントを作り、名前を
プラットフォーム → MARSにします。 リアクション用ブループリントとは別にしておくと管理が楽です。 - プラットフォーム受信ノードを配置します。例: チジクならチジクチャット受信。
- Moraecat カテゴリから MARS イベント入力ノードを配置します。
- MARS イベント入力のイベント種別を選びます。チャットノードに接続する場合はチャット、投げ銭ノードなら投げ銭。 イベント種別を変更すると下のフィールド名がその種別に合わせて切り替わります。(例: 投げ銭 → 金額・メッセージ・投げ銭の種類、サブスクリプション → 月数・メッセージ・ティア)
- 下の表に従って線を引きます。フロー出力(→ の形)は実行に、データは同じ意味のフィールドに接続します。ないフィールドは空欄のままで構いません。
- シーンを保存します。
チジクチャット受信CHZZK プラグイン
MARS イベント入力イベント種別: チャット
イベントごとに MARS イベント入力を1 つずつ置きます。チャットと投げ銭の両方を使う場合はイベント入力ノードも 2 つになります。
チジク(CHZZK プラグイン)
| 受信ノード | MARS イベント種別 | 受信ノード出力 → MARS イベント入力 |
|---|---|---|
| チジクチャット受信 | チャット | Exit → 実行 · Nickname → ニックネーム · SenderChannelId → ユーザー ID · Content → メッセージ |
| チジク投げ銭受信 | 投げ銭 | Exit → 実行 · DonatorNickname → ニックネーム · DonatorChannelId → ユーザー ID · PayAmount → 金額 · DonationText → メッセージ · DonationType → 投げ銭の種類 |
| チジクサブスクリプション受信 | サブスクリプション | Exit → 実行 · SubscriberNickname → ニックネーム · SubscriberChannelId → ユーザー ID · Month → 月数 · TierName → ティア |
SOOP(SOOP プラグイン)
| 受信ノード | MARS イベント種別 | 受信ノード出力 → MARS イベント入力 |
|---|---|---|
| SOOP チャットメッセージ | チャット | Exit → 実行 · UserNickname → ニックネーム · UserId → ユーザー ID · Message → メッセージ |
| SOOP スターバルーンギフト | 投げ銭 | Exit → 実行 · UserNickname → ニックネーム · UserId → ユーザー ID · Count → 金額(スターバルーン数) |
| SOOP 連続サブスクリプション | サブスクリプション | Exit → 実行 · UserNickname → ニックネーム · UserId → ユーザー ID · SubscriptionMonths → 月数 |
| SOOP サブスクリプション | サブスクリプション | Exit → 実行 · UserNickname → ニックネーム · UserId → ユーザー ID |
スターバルーンは個数で入ってきます
SOOP スターバルーンの Count は金額ではなくスターバルーンの個数です。ルールの金額条件も個数で入力します。(例: スターバルーン 10 個 → 基準金額 10)
Twitch(Warudo 標準機能)
| 受信ノード | MARS イベント種別 | 受信ノード出力 → MARS イベント入力 |
|---|---|---|
| トウィッチチャンネルメッセージを受け取ったとき | チャット | Exit → 実行 · UserDisplayName → ニックネーム · Username → ユーザー ID · Message → メッセージ |
| Twitch ビットを受け取ったとき | 投げ銭 | Exit → 実行 · UserDisplayName → ニックネーム · Username → ユーザー ID · BitsUsed → 金額 · Message → メッセージ |
| Twitch サブスクリプションを受け取ったとき | サブスクリプション | Exit → 実行 · UserDisplayName → ニックネーム · Username → ユーザー ID · CumulativeMonths → 月数 · Message → メッセージ |
| Twitch チャンネルポイントを受け取ったとき | チャンネルポイント | Exit → 実行 · UserDisplayName → ニックネーム · Username → ユーザー ID · RewardCost → ポイント · UserInput → 視聴者のテキスト · RewardTitle → 報酬名 |
| トウィッチチャンネルフォローを受け取ったとき | フォロー | Exit → 実行 · UserDisplayName → ニックネーム · Username → ユーザー ID |
| Twitch レイドを受け取ったとき | レイド | Exit → 実行 · RaiderDisplayName → ニックネーム · RaiderUsername → ユーザー ID · RaiderViewerCount → 視聴者数 |
Twitch ノードの説明は Warudo ノードリファレンスにもあります。
ポート名が異なって見える場合
表の英語名はプラグインが内部で使うポート名です。Warudo の言語設定やプラグインのバージョンによって、ノード上には日本語名で表示されることがあります。上から下への順番は同じです。
配信なしで確認する
実際のチャットがなくても確認できます。
- チジク: チジク受信テストノードのテストボタンで、仮のチャット・投げ銭を送れます。内容に
!Throwを入れてクリックしてみてください。 - 共通: キーを押したときノードを MARS イベント入力の実行に接続し、イベント入力のイベント種別をチャット、メッセージを
!Throwと直接入力してそのキーを押します。
MARS イベント入力の成功は「リクエストを受け付けた」という意味です(リアクションが終わったという意味ではありません)。拒否で出力された場合は、ノードの最近のエラーとハブ MARS 実行状態の最近の通知を確認してください。
確認
- 配信チャット(またはテスト)で
!Throwを送ると猫が飛んできます。 !throw(小文字)や!Throw!は実行されません。ルールが完全一致に設定されているためです。- ハブ MARS 実行状態で実行中・待機数が変わってから 0 に戻ります。
次のステップ: 4. 自分のリアクションを MARS 対応にする