Unity ゲームサーバー (Multiplay Hosting) からの呼び出し
Multiplay Hosting を使用して、専用ゲームサーバーからモジュールエンドポイントを呼び出すことができます。
ノート: モジュールが過去 15 分間にトラフィックを受信しなかった場合、コールドスタートの待ち時間が発生する可能性があります。その後のモジュールへの呼び出しは、より高速になります。
前提条件
- Cloud Code を呼び出すゲームサーバーおよび関連リソースは、同じ Unity Cloud Dashboard プロジェクト と 環境 に存在する必要があります。
- Multiplay Hosting でオンボードします。
Cloud Code の呼び出し
以下のステップに従って、ゲームサーバーから Cloud Code モジュールエンドポイントを呼び出します。
認証
Multiplay Hosting トークン または ステートレストークン を使用してリクエストを認証できます。受信したトークンを Bearer トークンとしてリクエストヘッダーで HTTP 認証に使用します。
Multiplay トークンでの認証が推奨されます。ステートレストークンで認証するにはサービスアカウントを作成し、秘密鍵を安全に保存する必要がありますが、Multiplay トークンではこれが不要で、管理の複雑さが軽減されます。
Multiplay Hosting トークンを使用した認証
こちら のゲームサーバーのドキュメントを参照してください。
ステートレストークンを使用した認証
ステートレストークンを使用するには、サービスアカウントを作成し、Token Exchange API を呼び出す必要があります。Cloud Code Client API の信頼されているクライアントの認証 に関するページを参照してください。
モジュールエンドポイントの呼び出し
コードベースにネイティブの HTTP ライブラリを使用してモジュールエンドポイントを呼び出すことができます。取得した認証トークンを Bearer トークンとしてリクエストヘッダーで HTTP 認証に使用します。Cloud Code API を使用してエンドポイントを呼び出す CURL リクエストの例は以下のようになります。
curl -X POST -H "Authorization: Bearer <BEARER_TOKEN>" 'https://cloud-code.services.api.unity.com/v1/projects/<PROJECT_ID>/modules/<MODULE_NAME>/<FUNCTION_NAME>'