セッションの作成 — Node.js
OpenTok セッションを生成するには、OpenTok Node.js ライブラリを使用できます。各セッションには一意のセッション ID が付与されており、この ID を OpenTok クライアントライブラリで使用することで、OpenTok セッションに接続できます。(詳細については、「セッションへの参加」を参照してください) ウェブ, iOSあるいは アンドロイド.)
OpenTok Media Router を使用するセッションの作成
以下の Node.js コードは、OpenTok Media Router を使用するセッションを作成します。
var opentok = new OpenTok(API_KEY, API_SECRET);
var sessionId;
opentok.createSession({mediaMode:"routed"}, function(error, session) {
if (error) {
console.log("Error creating session:", error)
} else {
sessionId = session.sessionId;
console.log("Session ID: " + sessionId);
}
});
OpenTok クライアントライブラリでセッション ID を使用して、OpenTok セッションに接続します。
また、OpenTokセッションに接続するユーザーごとにトークンを生成する必要があります。詳しくは、 接続トークンの作成 に関する情報は、 generateToken() メソッドを使用する。
について OpenTok メディアルーター には次のようなメリットがある:
- OpenTok Media Router を使用すると、多者間セッションにおける帯域幅の使用量を削減できます。(mediaMode プロパティが MediaMode.RELAYED に設定されている場合、各クライアントは、そのストリームを購読している各クライアントに対して、個別の音声・動画ストリームを送信する必要があります。)
- OpenTok Media Router は、以下の機能を通じてユーザー体験の質を向上させることができます。 オーディオのフォールバックとビデオのリカバリー. これらの機能により、クライアントの接続状態が、購読しているストリームの動画を再生できないほど悪化した場合、そのクライアントでは動画の再生が停止され(他のクライアントには影響しません)、音声のみが再生されます。クライアントの接続状態が改善すると、動画の再生が再開されます。
- OpenTok Media Router は、以下の機能をサポートしています。 アーカイブ機能、これにより、OpenTokのセッションを録画、保存、および再生することができます。
中継セッションの作成
以下は、 メディアモード 中継設定:
var opentok = new OpenTok(API_KEY, API_SECRET);
var sessionId;
opentok.createSession({mediaMode:"relayed"}, function(error, session) {
if (error) {
console.log("Error creating session:", error)
} else {
sessionId = session.sessionId;
console.log("Session ID: " + sessionId);
}
});
中継セッションでは、クライアント同士が直接ストリームを送信しようとします。ただし、ファイアウォールの制限によりクライアント同士が接続できない場合、セッションではOpenTokのTURNサーバーを使用して音声・映像ストリームを中継します。
重要だ: アーカイブなどの一部の機能は、ルーティングされた(中継されない)セッションでのみ利用可能です。ルーティングされたセッションの作成方法については、前のセクションを参照してください。
自動的にアーカイブされるセッションの作成
自動的にアーカイブされるセッションを作成することができます。以下は、自動的にアーカイブされるセッションを作成する Node.js のサンプルコードです:
opentok.createSession({mediaMode:'routed', archiveMode:'always'}, function(err, session) {
if (error) {
console.log("Error creating session:", error)
} else {
sessionId = session.sessionId;
console.log("Session ID: " + sessionId);
}
});
なお、アーカイブされたセッションでは、ルーティングされたメディアモードを使用する必要があります。
詳細は アーカイビング 開発者ガイド
クライアントアプリケーションでセッションを使用する
セッションIDを OpenTok クライアント SDK OpenTokセッションに接続するには。
また、OpenTokセッションに接続するユーザーごとにトークンを生成する必要があります。詳しくは、 接続トークンの作成 に関する情報は、 generateToken() メソッドを使用する。