接続トークンの作成 — Python
OpenTokセッションに接続するユーザーを認証するには、クライアントはトークンを使用して接続する必要があります(参照: この概要).
以下のPythonコード例は、OpenTokのPythonサーバーサイドライブラリを使用してトークンを生成する方法を示しています:
コピー
import OpenTok
# Replace with your OpenTok API key:
api_key = "your_API_key"
# Replace with your OpenTok API secret:
api_secret = "your_API_secret"
# Replace with the representative URL of your session:
session_address = "192.0.43.10"
opentok_sdk = OpenTok.OpenTok(api_key, api_secret)
session = opentok_sdk.create_session(session_address)
token = opentok_sdk.generate_token(session.session_id)
print token
を呼び出す。 generate_token() このメソッドは文字列を返します。この文字列がトークンです。
以下の Python コード例は、「publisher」というロールを持ち、接続メタデータ文字列を含むトークンを取得する方法を示しています:
コピー
import OpenTok
# Replace with your OpenTok API key:
api_key = "your_API_key"
# Replace with your OpenTok API secret:
api_secret = "your_API_secret"
# Replace with the representative URL of your session:
session_address = "192.0.43.10"
opentok_sdk = OpenTok.OpenTok(api_key, api_secret)
role_constants = OpenTok.RoleConstants
session = opentok_sdk.create_session(session_address)
connectionMetadata = "username=Bob,userLevel=4"
token = opentok_sdk.generate_token(session.session_id, role_constants.PUBLISHER, None, connectionMetadata)
print token
このメソッドは、以下の引数を受け取ります:
session_id(文字列) — ユーザーが接続するセッションに対応するセッション ID。role(文字列) — オプション。ユーザーが持つ役割を定義します。役割には、「サブスクライバー」、「パブリッシャー」、「モデレーター」の3つがあります。サブスクライバーは、セッション内のストリームを購読することしかできません(配信はできません)。 パブリッシャーは、セッションへのストリームの購読および配信が可能で、シグナリングAPIも使用できます。モデレーターはパブリッシャーと同様の権限を持ち、さらに他のユーザーに対してセッションからの切断や配信の中止を強制することもできます。値が指定されていない場合のデフォルトの役割はパブリッシャーです。connection_data(文字列) — 省略可能。接続に関するメタデータを含む文字列です。たとえば、ユーザー ID や名前、あるいは接続に関するその他のデータを渡すことができます。このデータは、Applications に応じて、サーバー側のデータベースから取得するか、クライアントから提供されたデータから取得することができます。expire_time(int) — 省略可能。トークンの有効期限。Unix タイムスタンプ(秒単位)の整数値として指定します。この値を指定しない場合、トークンは作成から 24 時間後に失効します。expire_time値が指定されている場合、その値は作成日時から30日以内である必要があります。