セッションの作成 — PHP

OpenTok PHP ライブラリを使用して、OpenTok セッションを生成することができます。各セッションには一意のセッション ID が付与されており、この ID を OpenTok クライアントライブラリで使用することで、OpenTok セッションに接続できます。(詳細については、「セッションへの参加」を参照してください) ウェブ, iOSあるいは アンドロイド.)

OpenTok Media Router を使用するセッションの作成

OpenTok Media Router を使用する以下のコード例:

<?php
    use OpenTok\OpenTok;

    $apiObj = new OpenTok($API_KEY, $API_SECRET);
    $session = $apiObj->createSession(array('mediaMode' => MediaMode::ROUTED));
    echo $session->getSessionId();
?>

OpenTok クライアントライブラリでセッション ID を使用して、OpenTok セッションに接続します。

OpenTok.js ライブラリを使用する HTML ページでは、次のように、API キー、セッション ID、および生成されたトークン文字列を参照する PHP を埋め込むことができます。

var apiKey = <?php print $API_KEY?>;
var sessionId = '<?php print $sessionId; ?>';
var token = '<?php print $apiObj->generateToken($sessionId); ?>';

また、OpenTokセッションに接続するユーザーごとにトークンを生成する必要があります。詳しくは、 接続トークンの作成 に関する情報は、 generateToken() メソッドを使用する。

について OpenTok メディアルーター には次のようなメリットがある:

  • OpenTok Media Router を使用すると、多者間セッションにおける帯域幅の使用量を削減できます。(中継セッションでは、各クライアントは、そのストリームを購読している各クライアントに対して、個別の音声・動画ストリームを送信する必要があります。)
  • OpenTok Media Router は、以下の機能を通じてユーザー体験の質を向上させることができます。 オーディオのフォールバックとビデオのリカバリー. これらの機能により、クライアントの接続状態が、購読しているストリームの動画を再生できないほど悪化した場合、そのクライアントでは動画の再生が停止され(他のクライアントには影響しません)、音声のみが再生されます。クライアントの接続状態が改善すると、動画の再生が再開されます。
  • OpenTok Media Router は、以下の機能をサポートしています。 アーカイブ機能、これにより、OpenTokのセッションを録画、保存、および再生することができます。

中継セッションの作成

以下は、 メディアモード 中継設定:

<?php
use OpenTok\OpenTok;

$apiObj = new OpenTok($API_KEY, $API_SECRET);

$session = $apiObj->createSession();
echo $session->getSessionId();
?>

中継セッションでは、クライアント同士が直接ストリームを送信しようとします。ただし、ファイアウォールの制限によりクライアント同士が接続できない場合、セッションではOpenTokのTURNサーバーを使用して音声・映像ストリームを中継します。

重要だ: アーカイブなどの一部の機能は、ルーティングされた(中継されない)セッションでのみ利用可能です。ルーティングされたセッションの作成方法については、前のセクションを参照してください。

自動的にアーカイブされるセッションの作成

自動的にアーカイブされるセッションを作成することができます。以下は、自動的にアーカイブされるセッションを作成するPHPのサンプルコードです:

$sessionOptions = array(
    'archiveMode' => ArchiveMode::ALWAYS,
    'mediaMode' => MediaMode::ROUTED
);
$session = $opentok->createSession($sessionOptions);

echo $session->getSessionId();

なお、アーカイブされたセッションでは、ルーティングされたメディアモードを使用する必要があります。

詳細は アーカイビング 開発者ガイド

クライアントアプリケーションでセッションを使用する

セッションIDを OpenTok クライアント SDK OpenTokセッションに接続するには。

また、OpenTokセッションに接続するユーザーごとにトークンを生成する必要があります。詳しくは、 接続トークンの作成 に関する情報は、 generateToken() メソッドを使用する。