セッションの管理

セッションは Vonage Client SDK を使用する上で不可欠な要素です。セッションはClient SDKとVonageサーバー間のライブ通信ストリームです。

セッションの作成

Vonage Client SDKで通話を開始するには、セッションを作成する必要があります。セッションを作成するための前提条件は、ユーザとそのユーザのJWTを持っていることです。ユーザとJWTについてはアプリケーションの作成ガイドを参照してください。ユーザーと関連するJWTを取得したら createSession 関数を使用してください。このガイドの例ではJavaScriptを使用しますが、関数名は3つのプラットフォームで共通です。

client.createSession(jwt)
 .then(sessionId => {
    console.log("Id of created session: ", sessionId);
 })
 .catch(error => {
    console.error("Error creating session: ", error);
 });

成功すると、セッションIDが発行されます。これにより、必要に応じてこの特定のセッションに再接続することができます。セッションのTTLは15分です。

セッションの再接続

既存のセッションに再接続する場合は createSession 関数はオプションでセッションIDをパラメータとして受け取ります。

client.createSession(jwt, existingSessionId)
 .then(sessionId => {
    console.log("Id of session: ", sessionId);
 })
 .catch(error => {
    console.error("Error: ", error);
 });

セッション作成のトラブルシューティング

セッションの作成に失敗した場合、返されるエラーメッセージから、その問題を知ることができます。以下に一般的なトラブルシューティングの手順を示します。

に GET リクエストを行い、Vonage User が存在することを確認する。ユーザーAPI
ユーザーが存在する場合は、そのユーザーが同じ地域 Vonage Client SDK が接続を試みていること。接続先の user._links オブジェクトが表示されます。
にJWTを入力します。 jwt.io でJWTが正しいユーザー名を持っていることを確認する。 sub を請求し、有効期限が切れていないことを確認する。ここで ACLパスが正しく、オブジェクトが正しいネスティングを持っている。

セッションのリフレッシュ

現在アクティブなセッションがあり、セッションを作成するために使用されたJWTがまもなく期限切れになることがわかっている場合、新しいJWTでセッションをリフレッシュすることができます。

client.refreshSession(jwt)
 .then(() => {
    console.log("Session refreshed");
 })
 .catch(error => {
    console.error("Error refreshing session: ", error);
 });

セッションの削除

セッションを削除することもできる。例えば、ログアウトフローの一部としてこれを行う。

client.deleteSession(jwt)
 .then(() => {
    console.log("Session deleted");
 })
 .catch(error => {
    console.error("Error deleting session: ", error);
 });

ご質問がおありですか？

ご不明な点、ご質問、ご意見等ございましたら、下記までご連絡ください。 devrel@vonage.com または Vonage開発者コミュニティSlack.