Unity Gaming Services CLI

Manage trigger configurations from the command line using the Unity Gaming Services command-line interface.

読み終わるまでの所要時間 5 分

最終更新 5ヶ月前

Unity Gaming Services CLI を使用して、トリガーを操作できます。CLI により、コマンドラインからトリガー設定を管理できます。

注

ノート: CLI は、フィルターを使用したトリガーをサポートしていません。フィルターを使用したトリガーを作成するには、Triggers Admin API または Unity Dashboard を使用します。

前提条件

CLI の詳細情報については、Unity Gaming Services CLI の使用の準備ガイドのステップに従います。

このガイドに従うには、最初に以下のアクションを実行する必要があります。

UGS CLI をインストールします。

プロジェクト ID と環境を以下のように設定します。

ugs config set project-id <your-project-id>

ugs config set environment-name <your-environment-name>

Triggers と環境管理に必要なロールでサービスアカウントを設定します。認証の取得を参照してください。

CLI の使用

すべてのコマンドとオプションの完全なリファレンスについては、Triggers コマンドラインのドキュメントを参照してください。

注

ノート:

ugs triggers

コマンドは

ugs tr

としても使用可能です。

トリガーのデプロイ

new-file

コマンドを実行して、トリガー設定をローカルに作成します。


ugs triggers new-file <file-name>

設定ファイルのコンテンツは以下のようになります。


{  "$schema": "https://ugs-config-schemas.unity3d.com/v1/triggers.schema.json",  "Configs": [    {      "Name": "example-trigger",      "EventType": "com.unity.services.scheduler.{{EVENT_NAME}}.v{{EVENT_VERSION}}",      "ActionUrn": "urn:ugs:cloud-code:MyScript",      "ActionType": "cloud-code"    }  ]}

設定ファイルを変更し、複数のトリガーを加えることもできます。


{  "$schema": "https://ugs-config-schemas.unity3d.com/v1/triggers.schema.json",  "Configs": [    {      "Name": "example-trigger",      "EventType": "com.unity.services.scheduler.{{EVENT_NAME}}.v{{EVENT_VERSION}}",      "ActionUrn": "urn:ugs:cloud-code:MyScript",      "ActionType": "cloud-code"    },    {      "Name": "example-trigger-2",      "EventType": "com.unity.services.scheduler.{{EVENT_NAME}}.v{{EVENT_VERSION}}",      "ActionUrn": "urn:ugs:cloud-code:MyScript",      "ActionType": "cloud-code"    }  ]}

Deploy

コマンドを使用して、ローカルトリガー設定ファイルをリモート環境にプロモートできます。

アクティブなトリガーになるように設定ファイルをデプロイする必要があります。


ugs deploy <path-to-triggers-file> <path-to-triggers-file>


ugs deploy <path-to-directory>

トリガーを既存の Cloud Code スクリプトまたはモジュールに関連付けている場合、

eventType

を指定してイベントを発行するとトリガーが発生し、関連付けられている Cloud Code スクリプトまたはモジュールが実行されます。

トリガーの取得

Fetch

コマンドを使用して、一度に複数のトリガーをリモートから取得できます。

指定されたパスは、トリガーの保存先のディレクトリです。


ugs fetch <path>

トリガーの削除

トリガーを削除するには、

--reconcile

フラグを指定して

deploy

コマンドを実行します。

注意

**注意: **リコンサイルは破壊的な操作です。指定されたパスに存在しないすべてのトリガーが削除されます。

--dry-run

フラグを使用してコマンドの出力を確認してから、フラグなしでコマンドを実行できます。


ugs deploy --services triggers <path-to-triggers-file> --reconcile

ドキュメント

Development

User Acquisition

Monetization

産業