facebook twitter hatena line email

Unity/Agora/voicechat community/token取得

提供: 初心者エンジニアの簡易メモ
2022年12月19日 (月) 19:46時点におけるAdmin (トーク | 投稿記録)による版 ("CAN_NOT_GET_GATEWAY_SERVER"エラーとなる場合)

移動: 案内検索

1日有効な本番token取得

  1. https://console.agora.io/ にアクセス
  2. stageをliveに
  3. Generate temp RTC tokenを選択して、チャンネル名を入れてtokenを取得
  4. サンプルのClientManagerTestシーンの、CanvasVideoのInspectorにあるuseTokenを、falseにして、token文字列を設置するとつながる

本番tokenをワンタイムtoken経由で取得する

  1. サンプルのClientManagerTestシーンだと、"VideoCanvas"のGameObjectとかに、TokenClientを、AddComponentする
  2. ServerURLを入れる。(ttp://localhost:8080/ な感じ。この場合ttp://localhost:8080/rte/testing/publisher/uid/1234/?3600 にアクセスされる)
  3. 以下のようにRtcEngine.JoinChannel()部分をtoken取得コードに変更

mRtcEngine.JoinChannel()部分をtoken取得コードに変更

string token = "";
if (!useToken)
{
    mRtcEngine.JoinChannel(token, CHANNEL_NAME_1, "", 0, new ChannelMediaOptions(true, true, true, true));
}
else
{
    TokenClient.Instance.SetRtcEngineInstance(mRtcEngine);
    TokenClient.Instance.GetRtcToken(CHANNEL_NAME_1, 0, (token) =>
    {
        mRtcEngine.JoinChannel(token, CHANNEL_NAME_1, "", 0, new ChannelMediaOptions(true, true, true, true));
    });
}

別チャンネルを作ってる場合

チャンネル名(例:"CHANNEL_NAME_VIDEO")をあわせる。

channelVideo = mRtcEngine.CreateChannel(CHANNEL_NAME_VIDEO);
if (!useToken)
{
    channelVideo.JoinChannel(token, "", 0, new ChannelMediaOptions(true, true));
}
else
{
    TokenClient.Instance.SetRtcEngineInstance(mRtcEngine);
    TokenClient.Instance.GetRtcToken(CHANNEL_NAME_VIDEO, 0, (token) =>
    {
        channelVideo.JoinChannel(token, "", 0, new ChannelMediaOptions(true, true));
    });
}

useTokenをtrueにすることでエラーになる場合

ArgumentNullException: String reference not set to an instance of a String.
Parameter name: source

TokenClientを、どこかのGameObjectにAddComponentしてServerURLを設定すれば良い。

token文字列が取得できない場合

token取得用apiと、unity設置してるサイトのドメインが同じでない場合は、network.errorになるので、ドメインは、同じにする。

"audience can not publish stream"エラーとなる場合

エラー詳細

Uncaught (in promise) AgoraRTCException: AgoraRTCError INVALID_OPERATION: audience can not publish stream

JoinChannel()前に、SetClientRole()を実行してないため起こる。JoinChannel()前に、SetClientRole()を実行すれば良い。

"renewToken should not be called before user join"エラーとなる場合

エラー詳細

AgoraRTCException: AgoraRTCError INVALID_OPERATION: renewToken should not be called before user join

参加前にrenewTokenを使ってるためで、対応方法を2パターン

パターン1

TokenClient.csのOnClientRoleChangedHandlerメソッド内の以下ChannelNameをpublicにし、joined判定変数を追加

- string ChannelName { get; set; }
+ public string ChannelName { get; set; }
+ bool joined = false;

SetRtcEngineInstanceに以下を追加

public void SetRtcEngineInstance(IRtcEngine engine)
{
    mRtcEngine = engine;
    mRtcEngine.OnTokenPrivilegeWillExpire = OnTokenPrivilegeWillExpireHandler;
    mRtcEngine.OnTokenPrivilegeDidExpire = OnTokenPrivilegeDidExpireHandler;
    mRtcEngine.OnClientRoleChanged += OnClientRoleChangedHandler;
+    mRtcEngine.OnJoinChannelSuccess += OnJoinChannelSuccess;
+    mRtcEngine.OnLeaveChannel += OnLeaveChannel;
}

OnClientRoleChangedHandlerに以下のStartCoroutine(TokenRequestHelper.FetchRtcToken(〜にjoined判定を追加

void OnClientRoleChangedHandler(CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole)
{
    clientType = newRole == CLIENT_ROLE_TYPE.CLIENT_ROLE_BROADCASTER ? ClientType.publisher : ClientType.subscriber;
    Debug.Log("Client Token will change for " + ChannelName + ", renewing from " + oldRole + " to " + newRole);
+    if (joined)
+    {
        StartCoroutine(TokenRequestHelper.FetchRtcToken(serverURL, ChannelName, UID, clientType.ToString(), ExpirationSecs, this.RenewToken));
+    }
}

OnJoinChannelSuccessとOnLeaveChannelメソッドを追加

void OnJoinChannelSuccess(string channelName, uint uid, int elapsed)
{
    Debug.LogFormat("TokenClient.OnJoinChannelSuccess JoinChannel={0} Success: uid ", channelName, uid);
    joined = true;
}
void OnLeaveChannel(RtcStats stats)
{
    Debug.LogFormat("TokenClient.OnLeaveChannel duration={0} txVideoBytes:{1} ", stats.duration, stats.txVideoBytes);
    joined = false;
}

SetRtcEngineInstanceの接続前に、"TokenClient.Instance.ChannelName = channel;"を追加

if (!useToken)
{
    mRtcEngine.JoinChannel(token, channel, "", 0, new ChannelMediaOptions(true, false, true, false));
}
else
{
+    TokenClient.Instance.ChannelName = channel;
    TokenClient.Instance.SetRtcEngineInstance(mRtcEngine);
    TokenClient.Instance.GetRtcToken(channel, 0, (token) =>
    {
        mRtcEngine.JoinChannel(token, channel, "", 0, new ChannelMediaOptions(true, false, true, false));
    });
}

パターン2

TokenClient.csのOnClientRoleChangedHandlerメソッド内の以下を、コメントアウトすれば、とりあえず、つながる。

// 以下が有ると、useToken時に、join前に、実行されてしまい、ChannelNameが空で、エラーとなり接続が止まるので、コメントアウト。問題あれば、再度考える
StartCoroutine(TokenRequestHelper.FetchRtcToken(serverURL, ChannelName, UID, clientType.ToString(), ExpirationSecs, this.RenewToken));

"Cannot read properties of undefined"エラーとなる場合

エラー詳細

Uncaught (in promise) TypeError: Cannot read properties of undefined (reading 'toString')

本番のAppIDで、useTokenを、falseにしてると、このようなエラーが出るので、AppIdをテスト用に。

golangでワンタイムtokenを設定

https://github.com/AgoraIO-Community/agora-token-service

agora-token-service設定

$ git clone https://github.com/AgoraIO-Community/agora-token-service.git
$ cp .env.example .env

.envを設定

APP_ID=
APP_CERTIFICATE=
$ go run cmd/main.go

phpでワンタイムtokenを取得する

git clone https://github.com/AgoraIO/Tools.git
$ agora-token/Tools/DynamicKey/AgoraDynamicKey/php をサーバーへ設置する。
  1. RtcTokenBuilderSample.phpを確認する
  2. serverURLにttp://localhost:8080/php/sample/RtcTokenBuilderSample.php?を設置する
  3. 処理すると、ttp://localhost:8080/php/sample/RtcTokenBuilderSample.php?/rtc/unity3d/publisher/uid/0/?expiry=3600 が実行される。
  4. このときrtcとuidの取得方法は、以下の通り。
if (preg_match("!/rtc/([\d\w]+)!", $_SERVER['QUERY_STRING'], $matches)) {
    $channelName = $matches[1];
}
if (preg_match("!/uid/([\d\w]+)!", $_SERVER['QUERY_STRING'], $matches)) {
    $uid = $matches[1];
    $uidStr = $matches[1];
}
if (preg_match("!/publisher/!", $_SERVER['QUERY_STRING'], $matches)) {
    $role = RtcTokenBuilder::RolePublisher;
} else if (preg_match("!/subscriber/!", $_SERVER['QUERY_STRING'], $matches)) {
    $role = RtcTokenBuilder::RoleSubscriber;
}

戻り値はjsonで

echo json_encode(array('rtcToken' => $token, 'rtmToken' => $token));

"CAN_NOT_GET_GATEWAY_SERVER"エラーとなる場合

エラー詳細

Agora-SDK [ERROR]: [client-1513c] join number: 1, Joining channel failed, rollback AgoraRTCException: AgoraRTCError CAN_NOT_GET_GATEWAY_SERVER: flag: 4096, message: AgoraRTCError CAN_NOT_GET_GATEWAY_SERVER: invalid token, authorized failed
  • AccessToken2Sample.phpではなく、RtcTokenBuilderSample.phpの方を使う。
  • token文字列がおかしいので、channelNameがちゃんと設定されてるか確認する。
  • 本番用Appなのに、tokenを使わなかった場合はこのエラーが出る。テスト用AppIdに切り替えるか、本番のAppIdでToken取得を使うように。

接続できないとき確認

  • AppIdが正しいか。tokenをonにしてるのに、AppIdがテスト用になってないかとか。