ドキュメント

サポート

Cloud Code

Unity Gaming Services CLI

Manage trigger configurations from the command line using the Unity Gaming Services command-line interface.
読み終わるまでの所要時間 1 分最終更新 23日前

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

前提条件

CLI の詳細情報については、Unity Gaming Services CLI の使用の準備ガイド のステップに従います。 このガイドに従うには、最初に以下のアクションを実行する必要があります。
  1. UGS CLI をインストール します。
  2. プロジェクト ID と環境を以下のように設定します。
    ugs config set project-id <your-project-id>

    ugs config set environment-name <your-environment-name>
  3. Triggers環境管理 に必要なロールでサービスアカウントを設定します。認証の取得 を参照してください。

CLI の使用

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

トリガーのデプロイ

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
コマンドを実行します。
ugs deploy --services triggers <path-to-triggers-file> --reconcile