Vivox アクセストークンと UAS の併用
Follow this workflow to use Vivox Access Tokens together with Unity Authentication Services.
読み終わるまでの所要時間 2 分最終更新 2日前
どのプレイヤーがどのチャンネルにアクセスできるかを完全に制御するために、自分のバックエンドで Vivox アクセストークン (VAT) を作成できます。
ヒント
**ヒント: **このフローは、既存の VAT フローを持つプロジェクトで、Vivox Safety スイートや他の Unity サービスをすべて活用する場合に特に便利です。
重要
重要: このフローは、通常の UAS トークンでは実現できない追加のチャンネルアクセス制御が必要な場合、または既存の VAT ユーザーで UAS と統合したい場合にのみ使用してください。
- Unity Cloud プロジェクトを設定する
- プロジェクト ID、環境 ID、環境名を確認してください。
- UAS カスタム ID プロバイダーを有効にする
- この設定のサービスアカウントの認証情報が手元にあることを確認してください。
VAT の作成
- Vivox SDK は、カスタムプロバイダー実装を使用する際に VAT が必要な場合にバックエンドに VAT をリクエストします。
- メソッド内で VAT をリクエストするときに、
GetTokenAsyncをバックエンドへのリクエストに追加します。accessToken - バックエンドで、トークンから必要な情報を検証して抽出し、Vivox アクセストークンを作成してそれをクライアントに送り返します。
クライアント側の設定
ゲームクライアントでは、Vivox SDK のIVivoxTokenProviderVivoxService.Instance.SetTokenProviderIVivoxTokenProvider.GetTokenAsyncIVivoxTokenProvider.GetTokenAsyncIVivoxTokenProvider.GetTokenAsyncサブスクライブするには
プレイヤーをサインインする前に、以下を使用してIVivoxTokenProviderVivoxService.Instance.SetTokenProvider(new CustomTokenProvider());
重要
重要: サブスクライブフローは v16.5.0 で変更されています。16.5.0 よりも前の Unity Vivox SDK バージョンでは、Vivox SDK を初期化する前に の実装を登録する必要がありました。
IVivoxTokenProviderトークンをフェッチする
オーバーライドされたメソッドで提供されているすべてのパラメーター (一部は空の場合あり) を使用してペイロードを作成し、安全なサーバーに送信して、Vivox アクセストークンを作成します。 すべてのパラメーターを送信することをお勧めします。ペイロードで必要なもののみが返されます。そのペイロードをGetTokenAsynctargetUserUrichannelUripublic class VoiceManager : MonoBehaviour{ async void Start() { // Must be done before any other Vivox action otherwise tokens will not be generated properly. VivoxService.Instance.SetTokenProvider(new VivoxTokenProvider()); await UnityServices.InitializeAsync(); await VivoxService.Instance.InitializeAsync(); }}class VivoxTokenProvider : IVivoxTokenProvider{ public Task<string> GetTokenAsync(string issuer = null, TimeSpan? expiration = null, string targetUserUri = null, string action = null, string channelUri = null, string fromUserUri = null, string realm = null) { if (!AuthenticationService.Instance.SessionTokenExists) { // Player not logged in! } var accessToken = AuthenticationService.Instance.AccessToken // Implement token fetching logic here. // The method parameters together with the accessToken from the AuthenticationService contain the necessary information for crafting the request payload. // This will be called whenever a token is needed for a Vivox action }}
サーバー側の設定
バックエンドサービスは、クライアントが必要なときに VAT を受け取るために 上記 のGetTokenAsyncsip:.issuer.unity_player_id.unity_environment_id.@domain.vivox.com
issuerunity_player_idunity_environment_idGetTokenAsyncaccessTokensubaudaudそれを使用して VAT を作成し、クライアントに送り返すことができます。{ "header": { "alg": "RS256", "kid": "<id>", "typ": "JWT" }, "payload": { "aud": [ "upid:{{unity_project_id}}", "envName:{{environment_name}}", "envId:{{unity_environment_id}}" // unity environment id ], "exp": 1617677595, // expires at "iat": 1617673872, // issued at "nbf": 1617673872, // not valid before "sub": "{{unity_player_id}}", // UAS player ID "project_id": "{{unity_project_id}}" // unity project id }}