MARS ノードリファレンス
ブループリントの Moraecat カテゴリにある MARS ノード 4 種類です。画面上のフィールド名は MARS の言語設定に従います(以下は日本語)。
| ノード | 配置場所 | 役割 |
|---|---|---|
| MARS リンク | リアクションブループリントの先頭 | MARS がリアクションを実行するときフローが始まる場所、イベントデータの取り出し |
| MARS 完了 | リアクションブループリントの末尾 | リアクションが終わったことを通知し、次のリクエストを実行させる |
| MARS イベント入力 | プラットフォーム接続用ブループリント | 配信イベントをハブへ送り、ルール条件を確認 |
| MARS 手動実行 | 任意のブループリント | ルールを経由せず特定のリアクションを直接実行 |
全体フロー
チジク投げ銭受信プラットフォームプラグイン
MARS イベント入力イベント種別: 投げ銭
MARS リンクハブが選んだリアクション
リアクション動作プロップ・モーション・カメラ
MARS 完了次のリクエスト開始
イベント入力とリンクの間には線を引きません。ハブが実行ルールでリアクションを選び、そのリアクションのリンクを呼び出します。
MARS リンク
リアクションブループリントの開始点です。MARS がこのリアクションを実行すると呼び出されたからフローが出ます。
MARS リンク
内部リアクション ID
自動
リアクション名
Throw
同一リアクションの重複実行を許可
NoYes
他のリアクションとの同時実行を許可
NoYes
▶呼び出された
カスタムパラメーター
リクエスト ID
ソース
イベント種別
ニックネーム
ユーザー ID
金額
メッセージ
種別
JSON データ
▶ 緑 = 実行(フロー)ポート · ● 白 = データポート。左が入力、右が出力です。
| 入力 | 説明 |
|---|---|
| 内部リアクション ID | 自動で決まる ID。変更しません。 |
| リアクション名 | ハブと .mars ファイルに表示される名前 |
| 同一リアクションの重複実行を許可 | Yes にすると、このリアクションが実行中でも同じリアクションのリクエストを重ねて実行 → 実行ポリシー |
| 他のリアクションとの同時実行を許可 | Yes にすると、他のリアクションと同時実行(相手も Yes である必要あり) |
| 出力 | 説明 |
|---|---|
| 呼び出された ▶ | リアクション実行開始 |
| カスタムパラメーター | ルールに設定した整数。同じリアクションをルールごとに使い分ける → カスタムパラメーター |
| リクエスト ID · ソース · イベント種別 | この実行を呼び出したリクエスト情報 |
| ニックネーム · ユーザー ID · 金額 · メッセージ · 種別 | イベントデータ。種別は投げ銭の種類・サブスクリプションティア・チャンネルポイント報酬名など |
| JSON データ | プラットフォームから送られた元データ(ある場合) |
- 1 つのブループリントにリンクは1 つだけ置きます。
- フローは必ず MARS 完了 まで到達させます。
MARS 完了
リアクションが終わったことを MARS に通知します。このシグナルが来て初めて、待機中の次のリクエストが実行されます。
MARS 完了
▶実行
完了後の追加待機時間
0
最近のエラー
▶成功
▶拒否
▶ 緑 = 実行(フロー)ポート · ● 白 = データポート。左が入力、右が出力です。
| ポート | 説明 |
|---|---|
| 実行 ▶ | 演出と後処理がすべて終わった地点に接続 |
| 完了後の追加待機時間 | 完了後もこの時間(秒)だけ実行中として保持。リアクション間の間隔調整 |
| 成功 ▶ / 拒否 ▶ | 完了処理の結果。拒否の場合は最近のエラーに理由が残る |
MARS リンク呼び出された
プロップ投げThrow Prop
待機演出が終わるまで
MARS 完了実行
開始直後に完了を呼び出すと、MARS はリアクションが終わったと見なし次のリクエストをすぐに開始します。待機・終了出力の後に接続してください。
MARS イベント入力
プラットフォーム受信ノードのイベントを MARS ハブへ送ります。ハブがルール条件を確認し、一致するリアクションを実行します。
MARS イベント入力
▶実行
イベント種別
選択...▾
ニックネーム
ユーザー ID
金額
0
メッセージ
種別
最近のエラー
▶成功
▶拒否
▶ 緑 = 実行(フロー)ポート · ● 白 = データポート。左が入力、右が出力です。
| ポート | 説明 |
|---|---|
| 実行 ▶ | プラットフォーム受信ノードのフロー出力(Exit)を接続 |
| イベント種別 | チャット・投げ銭・サブスクリプション・チャンネルポイント・レイドなど。変更するとフィールド名が種別に合わせて切り替わる |
| ニックネーム · ユーザー ID · 金額 · メッセージ · 種別 | 受信ノードの対応する出力を接続。ないフィールドは空欄のまま |
| 成功 ▶ | リクエストを受け付けたという意味(リアクションが終わったという意味ではない) |
| 拒否 ▶ | 受け付けられなかった。理由は最近のエラーとハブの最近の通知に |
チジクチャット受信CHZZK プラグイン
MARS イベント入力イベント種別: チャット
イベントごとにイベント入力を1 つずつ置きます。プラットフォームごとの接続表は配信プラットフォームの接続にあります。
MARS 手動実行
ルールを経由せず、選んだリアクションを直接実行します。他のブループリントからリアクションを呼び出したいときに使います。
MARS 手動実行
▶実行
リアクション
選択...▾
ソース
イベント種別
ニックネーム
ユーザー ID
金額
0
メッセージ
種別
JSON データ
最近のエラー
▶成功
▶拒否
▶ 緑 = 実行(フロー)ポート · ● 白 = データポート。左が入力、右が出力です。
| ポート | 説明 |
|---|---|
| リアクション | 実行するリアクション(ルールではなくリアクションを選ぶ) |
| ソース · イベント種別 · ニックネーム · … | リアクションの MARS リンク出力にそのまま渡す値 |
| 成功 ▶ / 拒否 ▶ | リクエストを受け付けたかどうか |
- カスタムパラメーターは 0 で実行されます。
- 実行ポリシーとキューはそのまま適用されます。 → 手動実行と復旧