質問・問題
Wildcard Token とは何ですか ?
回答・解決方法
Wildcard Token とは、複数のチャンネルをより簡単に行き来できる特殊なトークンです。
通常のトークンと比べて、新しいチャンネルに接続する毎にトークンの再生成が必要ありません。
トークンの概要につきましては、別 FAQ をご覧ください:
Wildcard Token は、チャンネル名情報として、ワイルドカード文字 *
を含む文字列を指定することで生成されます。
例えば文字列 Agora*
で生成したトークンは、チャンネル Agora
AgoraChannel
AgoraAwesome
には有効ですが、チャンネル AppTest
への接続はできません。
ワイルドカード文字は複数回使用可能です。
例: a*o*a
の場合、agora
aloha
など。
どのような場合に Wildcard Token を使うべきですか ?
アプリのユースケースとして、ユーザーが複数チャンネルを頻繁に行き来するシナリオが求められる場合は Wildcard Token を使用することをお勧めします。 チャンネル毎にトークンを生成する回数が減るので、トークン発行サーバーにかかる負担も軽減できます。
どの SDK が Wildcard Token をサポートしていますか ?
(2023-09 時点において) Web を除く、全ての 4.x Video/Voice SDK が対象となります。
Wildcard Token を使う場合、既存の Generator や SDK を更新する必要はありますか ?
(1) ご利用の Video/Voice SDK のバージョンが 4.x であること、(2) トークン生成ツール (Generator) として AccessToken2 を使用していること、を満たしている場合、更新の必要はありません。
今使っている Voice/Video SDK が 4.x であることを確認する方法はありますか ?
(1) getSdkVersion() API が返す値を確認するか、もしくは (2) Call Inspector から、テスト接続をした通話情報の Sender's view または Receiver's view を確認ください。
今使っている Token 生成ツールが AccessToken2 であることを確認する方法はありますか ?
現在ご利用の Token Generator が出力するトークン値をご確認ください。 AccessToken2 の場合、出力された トークンの最初の 3 文字に 007
が含まれています。
AccessToken から AccessAccessToken2 へのアップグレードが必要な場合、公式ドキュメントをご参考ください: