禁用 Agora 的默认屏幕共享按钮

介绍

Agora 是一个提供实时通讯软件开发工具的平台，其中包括实时音视频通话、实时消息、互动直播等功能。在 Agora 的实时音视频通话中，屏幕共享是一个非常有用的功能。然而，默认情况下，Agora 在通话中会显示一个屏幕共享按钮，让用户可以方便地使用屏幕共享功能。有时，我们需要禁用这个按钮。那么，如何禁用 Agora 的默认屏幕共享按钮呢？

解决方案

禁用 Agora 的默认屏幕共享按钮有两个解决方案，一是使用 Agora 提供的 SDK 接口，二是使用自定义 UI。

解决方案一：使用 Agora 提供的 SDK 接口

Agora 提供了一个叫做 setupLocalVideo 的接口，可以设置本地视频的显示属性，包括是否显示视频、是否镜像等。通过该接口，我们可以在通话中隐藏屏幕共享按钮，具体实现如下：

// Java 接口
mRtcEngine.setupLocalVideo(new VideoCanvas(null, VideoCanvas.RENDER_MODE_HIDDEN, 0));

// Swift 接口
rtcEngine.setupLocalVideo(VideoCanvas(view: nil, renderMode: .hidden, uid: 0))

以上接口将本地视频的显示模式设为隐藏，即不显示视频图像。这样，屏幕共享按钮也将不再显示在通话中。

解决方案二：使用自定义 UI

如果使用默认 UI，我们可以在设置视频配置时指定 RENDER_MODE_HIDDEN，但是如果使用自定义 UI，则可以通过自定义 UI 的方式隐藏屏幕共享按钮。具体实现如下：

<!-- XML 文件中添加以下代码 -->
<AgoraSurfaceView
    android:id="@+id/local_surface_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:mode="hidden" />

以上代码将 AgoraSurfaceView 的显示模式设为隐藏，即不显示视频图像。这样，屏幕共享按钮也将不再显示在通话中。

总结

以上是禁用 Agora 默认屏幕共享按钮的两种解决方案。如果我们需要禁用屏幕共享按钮，只需使用 SDK 提供的 setupLocalVideo 接口或自定义 UI 的方式即可。