ビデオの一時停止イベント
ピアが自分のビデオストリームを一時停止または再開するとイベントが発生します。
| 対応する通話タイプ | SDKの最低バージョン |
|---|---|
| 1対1通話、グループ通話(カンファレンス) | PlanetKit 3.0 |
1対1通話
1対1通話では、ピアのビデオが一時停止または再開されると、以下のようなイベントコールバックが呼び出されます。
| イベントコールバック | 説明 |
|---|---|
peerVideoDidPause | ピアのビデオが一時停止されたときに呼び出されます。 |
peerVideoDidResume | ピアのビデオが再開されたときに呼び出されます。 |
グループ通話
グループ通話では、1人以上のピアのビデオが一時停止または再開されると、以下のようなイベントコールバックが呼び出されます。
| イベントコールバック | 説明 |
|---|---|
peersVideoDidUpdate | 1人以上のピアのビデオが一時停止または再開されたときに呼び出されます。 - ピアのビデオが一時停止された場合、ピアの PlanetKitVideoStateはpausedです。- ピアのビデオが再開された場合、ピアの PlanetKitVideoStateはenabledです。 |
ビデオを一時停止する理由
ユーザー指示やカメラ使用不可など、さまざまな理由でビデオストリームを停止することができます。
1対1通話も、グループ通話もビデオを一時停止する際にイベントコールバックを通じてビデオの一時停止の理由を渡します。PlanetKitVideoPauseReasonenumは、以下のようにビデオを一時停止する理由を定義します。
| Enum定数 | 説明 |
|---|---|
user | ピアがpauseMyVideo()を呼び出しました |
interrupt | アプリケーションがバックグラウンド状態に入りました |
enableVideoResponse | (1対1通話のみ可能)ピアがビデオ通話を有効にした後、ユーザーのビデオは一時停止されます。詳しくは、音声通話中のビデオ通話の有効化を参照してください。 |
cameraInactive | カメラが使用できなくなりました |
hold | ピアがhold()を呼び出しました。詳しくは、通話の一時停止を参照してください。 |