Video pause event
LINE Planet generates events when one or more peers pause or resume their video streams.
| Supported call type | Minimum SDK version |
|---|---|
| 1-to-1 call, group call (conference) | WebPlanetKit 3.1 |
1-to-1 call
In 1-to-1 calls, the following event callbacks are invoked when a peer's video is paused or resumed.
| Event callback | Description |
|---|---|
evtPeerVideoPaused of MakeCallDelegateevtPeerVideoPaused of VerifyCallDelegate | Invoked when a peer's video is paused |
evtPeerVideoResumed of MakeCallDelegateevtPeerVideoResumed of VerifyCallDelegate | Invoked when a peer's video is resumed |
Group call
In group calls, the following event callbacks are invoked when one or more peers' video is paused or resumed.
| Event callback | Description |
|---|---|
evtPeersVideoPaused | Invoked when one or more peers' video is paused |
evtPeersVideoResumed | Invoked when one or more peers' video is resumed |
Video pause reason
A video stream can be paused for various reasons, such as a user choosing to pause the video or the camera being disabled.
For both 1-to-1 calls and group calls, the reason for video pause is delivered in the event callbacks when video is paused. The VIDEO_PAUSE_REASON enum defines the following reasons for video pause.
| Enum constant | Description |
|---|---|
PLANETKIT_VIDEO_PAUSE_REASON_BY_USER | When a peer calls pauseMyVideo() |
PLANETKIT_VIDEO_PAUSE_REASON_BY_INTERRUPT | When the app enters background status |
PLANETKIT_VIDEO_PAUSE_REASON_ENABLE_VIDEO_RESPONSE | (Only for 1-to-1 calls) When the peer has set the response type to PAUSE and the user makes a request for enabling a video call. For more information, refer to Enable video call from audio call. |
PLANETKIT_VIDEO_PAUSE_REASON_CAMERA_INACTIVE | When the camera device is being disabled |
Interface changes
The following changes have been made to the APIs related to the video pause event.
| SDK version | 1-to-1 call | Group call |
|---|---|---|
| WebPlanetKit 5.0 or higher | evtPeerVideoPausedevtPeerVideoResumed | evtPeersVideoPausedevtPeersVideoResumed |
| WebPlanetKit 4.2 or lower | evtPeerUpdated | evtPeerUpdated |
Up to WebPlanetKit 5.1, in a group call, the shareVideoPause property (default value is false) in ConferenceParams must be set to true to enable sharing the user's own video pause status with others. The shareVideoPause property has been removed since PlanetKit 5.2.