最終更新日:2024-06-11 09:31:35
このガイドは、WebアプリケーションでWebRTC Player SDKを効果的に統合し利用するための詳細な手順を開発者に提供します。設定、構成、および使用手順を概説し、さまざまなプラットフォームで安定したビデオ再生を確保します。
HTMLに<video>
タグを作成し、自動再生とコントロール機能を追加して、モダンブラウザでのHTML5ビデオ再生をサポートします。
<video id="videotest" class="centeredVideo" controls autoplay width="1024" height="576">
ご使用のブラウザはHTML5ビデオをサポートしていません。
</video>
HTMLドキュメントにSDKのJavaScriptファイルを含め、その機能を利用します。
<script src="wsrtcplayer.min.js"></script>
再生イベントを効果的に管理するために、強力なイベントコールバック関数を定義します。これらの関数は、再生中断、データ受信、ネットワーク応答などの重要な状況を処理するのに役立ちます。
/***** カスタムコールバック関数
@argument arguments[0]: イベントタイプ:
0 - バッファから再生を再開
1 - バッファリングイベントが発生
2 - サーバーがセッション記述プロトコル(SDP)データで応答
@argument arguments[1]: サーバーからのSDP文字列、イベントタイプ2の場合のみ関連
*****/
function onEvent() {
// ここに強力なイベント処理ロジックを追加します
}
window.wsrtcplayer.callback = onEvent;
指定された構成オプションでプレーヤーインスタンスを初期化します。
var option = {
element: document.getElementById('videotest'),
customerID: "XXXX",
listener: onEvent
};
var player = window.wsrtcplayer.createWSRTCPlayer(option);
シグナリングURLを使用してストリームの再生を開始します。
// @param signal_url: 再生ストリームのシグナリングURL
player.open(signal_url);
WebRTCでは、シグナリングは通信セッションの設定、管理、および終了に使用されるプロセスです。シグナリングURLは、以下の形式で構成します:
signal_url: http(s)://domain/appName/streamName.sdp
再生を停止するには、close関数を呼び出します。
player.close();
具体的な例については、SDK内のdemo.html
を参照してください。
以下はWebRTC互換性の概要です:
オペレーティングシステム | ブラウザの種類 | 最低バージョン要件 |
---|---|---|
Mac OS | デスクトップ版 Safari | 11+ |
Mac OS | デスクトップ版 Chrome | 47+ |
Windows | デスクトップ版 Chrome | 56+ |
Android | モバイル版 Chrome | 88+ |
iOS | モバイル版 Safari | 11+ |
iOS | WeChat埋め込みブラウザ | 12+ |
注意: Chromeエンジンを使用するブラウザは、対応するChromeのバージョンを参照してください。Androidデバイスのブラウザ互換性は機種によって異なり、一部のモデルはH264デコードをサポートしていない場合があります。