接続トークンの作成 — PHP

OpenTokセッションに接続するユーザーを認証するには、クライアントはトークンを使用して接続する必要があります（参照：この概要).

以下のPHPコード例は、OpenTokのPHPサーバーサイドライブラリを使用してトークンを生成する方法を示しています：

<?PHP

use OpenTok\OpenTok;

$opentok = new OpenTok(API_KEY,API_SECRET);
// Replace with the correct session ID:
print $opentok->generateToken('your_session_ID');
print "\n";
?>

を呼び出す。 generateToken() このメソッドは文字列を返します。この文字列がトークンとなります。サーバーサイドのPHPコードを使用して、このトークンを配信されるWebページに組み込んでください。

以下のPHPコード例は、「publisher」というロールを持ち、接続メタデータ文字列を含むトークンを取得する方法を示しています：

<?PHP

use OpenTok\OpenTok;

$opentok = new OpenTok(API_KEY,API_SECRET);
// Replace with meaningful metadata for the connection:
$connectionMetaData = "username=Bob,userLevel=4";
// Replace with the correct session ID:
print $opentok->generateToken('your_session_ID', array('role' => Role::PUBLISHER, 'expireTime' => time()+(7 * 24 * 60 * 60), 'data' =>  $connectionMetaData);
print "\n";
?>

このメソッドは、以下の引数を受け取ります：

session_id (文字列) — ユーザーが接続するセッションに対応するセッション ID。
options (オプション) — トークンのオプションを含む配列：
- role (文字列) — オプション。ユーザーが持つ役割を定義します。役割には、「サブスクライバー」、「パブリッシャー」、「モデレーター」の3つがあります。サブスクライバーは、セッション内のストリームを購読することしかできません（配信はできません）。パブリッシャーは、セッションへのストリームの購読および配信が可能で、シグナリングAPIも使用できます。モデレーターはパブリッシャーと同様の権限を持ち、さらに他のユーザーに対してセッションからの切断や配信の中止を強制することもできます。値が指定されていない場合のデフォルトの役割はパブリッシャーです。
- expireTime (int) — 省略可能。トークンの有効期限。Unix タイムスタンプ（秒単位）の整数値として指定します。この値を指定しない場合、トークンは作成から 24 時間後に失効します。 expireTime 値が指定されている場合、その値は作成日時から30日以内である必要があります。
- data (文字列) — 省略可能。接続に関するメタデータを含む文字列です。たとえば、ユーザー ID や名前、あるいは接続に関するその他のデータを渡すことができます。このデータは、Applications に応じて、サーバー側のデータベースから取得するか、クライアントから提供されたデータから取得することができます。