setClientRole abstract method

Future<void> setClientRole({
  1. required ClientRoleType role,
  2. ClientRoleOptions? options,
})

设置直播场景下的用户角色和观众端延时级别。

SDK 默认设置用户角色为观众，你可以调用该方法设置用户角色为主播。用户角色（ role ）确定用户在 SDK 层的权限，包含是否有发流权限等。 当用户角色设为主播时，观众端延时级别仅支持设置为 audienceLatencyLevelUltraLowLatency（超低延时）。 在加入频道前调用该方法并将 role 设为 BROADCASTER （主播）时，本地不会触发 onClientRoleChanged 回调。

  • role 用户角色。详见 ClientRoleType 。 角色为观众的用户无法在频道内发布音视频流。在直播场景下发流时，请确保你的用户角色已切换为主播。
  • options 用户具体设置，包含用户级别。详见 ClientRoleOptions 。

Returns 方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

Implementation

Future<void> setClientRole(
    {required ClientRoleType role, ClientRoleOptions? options});