功能场景

在使用云手机做直播的场景中，部分使用者仅有观看权限，无操控云手机的权限，仅少量管理员具有操控权限，操控权限需要灵活配置。

• 操控组：全部通过 RTC 流连接到云手机，支持多个用户同时具有操控权限，能够进行控制权转移。
• 观众组：通过 CDN/RTC 拉取直播流，没有操控权限。

功能介绍

当多个用户通过不同客户端连接到同一云手机实例时，支持调用 enableControl 接口开启或关闭指定用户对云手机的操控权。调用 hasControl 接口支持查询本用户有无操控权限。调用 getAllControls 接口查询所有连接云机实例的用户的操控权信息。

相关API

Web

详细信息，参考 接口说明。

//设置指定 user 是否具有云手机操控权
vePhone.enableControl(userId,enable);

//异步查询指定 user 是否具有云手机操控权
vePhone.hasControl(userId);

//异步查询所有具有操控权的用户信息
vePhone.getAllControls();

Android

详细信息，参考 接口说明。

/**
  * 设置指定 user 是否具有云手机操控权。默认每个用户进房时都具备操控权，可以通过本接口动态关闭控制权。<br>
  * 操作结果通过 {@link ControlListener#onEnableControlResult(int, ControlState, String)} 返回。
  *  @param userId 用户ID
  *  @param enable true-开启云手机操控权； false-关闭云手机操控权
  *  @return 0：方法调用成功； -1：方法调用失败
  */
int enableControl(String userId, boolean enable);

/**
  * 异步查询指定 user 是否具有云手机操控权。<br>
  * 结果通过 {@link ControlListener#onHasControlResult(int, ControlState, String)} 返回。
  *  @param userId 用户ID
  *  @return 0：方法调用成功； -1：方法调用失败
  */
int hasControl(String userId);

/**
  * 异步查询所有用户的操控权信息。<br>
  * 结果通过 {@link ControlListener#onAllControlsResult(int, List, String)} 返回。
  *  @return 0：方法调用成功； -1：方法调用失败
  */
int getAllControls();

iOS

详细信息，参考 接口说明。

/// 设置指定用户是否拥有操控权
/// - Parameter controlObj: 参数
/// - Notes 每个新用户进房时默认具备操控权，可以通过本接口动态关闭控制权，调用此接口，会触发”phoneManager:onEnableControlResult:state:message:“回调
- (void)enableControl:(VePhoneControlState *)state;

/// 异步查询指定用户是否拥有操控权
/// - Parameter userId: 用户ID
/// - Notes 调用此接口，会触发”phoneManager:onHasControlResult:state:message:“回调
- (void)hasControl:(NSString *)userId;

/// 异步查询所有用户是否拥有操控权
/// - Notes 调用此接口，会触发”phoneManager:onAllControlsResult:list:message:“回调
- (void)getAllControls;

示例代码

Web

https://github.com/volcengine/vePhone/blob/main/Quick%20Start/Web/src/features/control-perm.js

Android

https://github.com/volcengine/vePhone/blob/main/Quick%20Start/Android/app/src/main/java/com/example/sdkdemo/feature/UserServiceActivity.java

iOS

https://github.com/volcengine/vePhone/tree/main/Quick%20Start/iOS