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