本文にスキップする
Version: 6.2

ビデオの一時停止イベント

ピアが自分のビデオストリームを一時停止または再開するとイベントが発生します。

対応する通話タイプSDKの最低バージョン
1対1通話、グループ通話(カンファレンス)PlanetKit 3.0

1対1通話

1対1通話では、ピアのビデオが一時停止または再開されると、以下のようなイベントコールバックが呼び出されます。

イベントコールバック説明
peerVideoDidPauseピアのビデオが一時停止されたときに呼び出されます。
peerVideoDidResumeピアのビデオが再開されたときに呼び出されます。

グループ通話

グループ通話では、1人以上のピアのビデオが一時停止または再開されると、以下のようなイベントコールバックが呼び出されます。

イベントコールバック説明
peersVideoDidUpdate1人以上のピアのビデオが一時停止または再開されたときに呼び出されます。
- ピアのビデオが一時停止された場合、ピアのPlanetKitVideoStatepausedです。
- ピアのビデオが再開された場合、ピアのPlanetKitVideoStateenabledです。

ビデオを一時停止する理由

ユーザー指示やカメラ使用不可など、さまざまな理由でビデオストリームを停止することができます。

1対1通話も、グループ通話もビデオを一時停止する際にイベントコールバックを通じてビデオの一時停止の理由を渡します。PlanetKitVideoPauseReasonenumは、以下のようにビデオを一時停止する理由を定義します。

Enum定数説明
userピアがpauseMyVideo()を呼び出しました
interruptアプリケーションがバックグラウンド状態に入りました
enableVideoResponse(1対1通話のみ可能)ピアがビデオ通話を有効にした後、ユーザーのビデオは一時停止されます。詳しくは、音声通話中のビデオ通話の有効化を参照してください。
cameraInactiveカメラが使用できなくなりました
holdピアがhold()を呼び出しました。詳しくは、通話の一時停止を参照してください。

関連ドキュメント