Spotlight a user

Spotlighting a user calls attention to that user's video for everyone in the session, regardless of who is talking. Spotlight is typically used by a host to emphasize a speaker or presenter. The Video SDK for iOS supports spotlighting multiple users at once.

Spotlight a user#

To highlight a user's video for all participants, call spotLightVideo on the ZoomVideoSDKVideoHelper with that user.

ZoomVideoSDK.shareInstance()?.getVideoHelper()?.spotLightVideo(user)

[[[ZoomVideoSDK shareInstance] getVideoHelper] spotLightVideo:user];

Remove spotlight from a user#

To drop a user from the spotlight, call unSpotLightVideo with that user.

ZoomVideoSDK.shareInstance()?.getVideoHelper()?.unSpotLightVideo(user)

[[[ZoomVideoSDK shareInstance] getVideoHelper] unSpotLightVideo:user];

Remove spotlight from everyone#

To clear the spotlight for every user at once, call unSpotlightAllVideos.

ZoomVideoSDK.shareInstance()?.getVideoHelper()?.unSpotlightAllVideos()

[[[ZoomVideoSDK shareInstance] getVideoHelper] unSpotlightAllVideos];

Get the list of spotlighted users#

Use getSpotlightedVideoUserList to retrieve every user who is currently spotlighted. This is useful when you need to render a different layout for spotlighted users (for example, in a larger view) or to update the UI when a user joins mid-session.

if let spotlighted = ZoomVideoSDK.shareInstance()?.getVideoHelper()?.getSpotlightedVideoUserList() {
    for user in spotlighted {
        // adjust your UI for each spotlighted user
    }
}

NSArray<ZoomVideoSDKUser *> *spotlighted = [[[ZoomVideoSDK shareInstance] getVideoHelper] getSpotlightedVideoUserList];
for (ZoomVideoSDKUser *user in spotlighted) {
    // adjust your UI for each spotlighted user
}

To react to spotlight changes as they happen, implement onSpotlightVideoChanged.