Android端实现屏幕共享

1.设置权限

为了在 Android 平台上实现稳定、兼容的屏幕共享功能，应用需在 AndroidManifest.xml 中添加以下权限声明与 Service 注册信息。

• FOREGROUND_SERVICE：用于启动前台服务，保证在后台状态下屏幕共享服务不被系统杀死。

• FOREGROUND_SERVICE_MEDIA_PROJECTION：Android 10（API 29）及以上版本引入的精细化权限，用于标识前台服务类型为屏幕采集（MediaProjection）。Android 14（API 级别 34）及以上必须声明该权限。

• POST_NOTIFICATIONS：从 Android 13（API 33）开始，应用如果需要发送通知（例如前台服务通知），必须声明此权限，未授权将无法启动前台服务通知。

• Service 声明：要实现前台服务，需要在AndroidManifest.xml 中声明对应的 Service 组件，否则，系统无法识别该服务，启动时会报错或者失败。

<manifest ...>
    <!-- 声明前台服务权限 -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
    <!-- Android 13 (API级别33）以上 -->
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/> 
    
    <application ...>
          <!-- 声明用于屏幕共享的前台Service -->
          <service android:name="com.alivc.rtc.share.ForegroundService"
            android:enabled="true" />
    </application>
</manifest>

2.相机流与屏幕共享流配置

ARTC 支持推送相机流和屏幕共享流，请根据业务场景灵活配置。

mAliRtcEngine.publishLocalVideoStream(false);

mAliRtcEngine.publishLocalVideoStream(true);

3.设置屏幕流编码配置

如果需要自定义屏幕共享视频流的编码属性，可以调用setScreenShareEncoderConfiguration接口进行配置，包含分辨率、帧率、码率、GOP、视频旋转方向。

相关配置如下：

示例代码如下：

AliRtcEngine.AliRtcScreenShareEncoderConfiguration screenShareEncoderConfiguration = new AliRtcEngine.AliRtcScreenShareEncoderConfiguration();
screenShareEncoderConfiguration.bitrate = bitrate;
screenShareEncoderConfiguration.dimensions = new AliRtcEngine.AliRtcVideoDimensions(width, height);
screenShareEncoderConfiguration.frameRate = fps;
screenShareEncoderConfiguration.keyFrameInterval = gop;
screenShareEncoderConfiguration.forceStrictKeyFrameInterval= mForceKeyFrameSwitch.isChecked();
mAliRtcEngine.setScreenShareEncoderConfiguration(screenShareEncoderConfiguration);

4.开始屏幕采集

调用 startScreenShare 接口启动屏幕采集流程，开始采集设备屏幕内容并推送至通话频道。根据你的应用场景进行参数设置：

1. intent：外部创建启动屏幕分享的Activity,外部未创建则传null,建议传null。

2. screenShareMode：屏幕共享模式,只共享音频/视频/音视频。

Button mStartScreenShareBtn = findViewById(R.id.start_screen_share_btn);
mStartScreenShareBtn.setOnClickListener(v -> {
    if(mAliRtcEngine != null) {
        // 配置屏幕共享流编码配置
        getScreenShareEncoderConfiguration();
        mAliRtcEngine.setScreenShareEncoderConfiguration(screenShareEncoderConfiguration);
        // 开启屏幕共享采集
        mAliRtcEngine.startScreenShare(null, screenShareMode);
    }
});

5.停止屏幕采集

调用 stopScreenShare 方法停止屏幕共享采集，结束屏幕内容的采集和推送，释放相关资源。

Button mStopScreenShareBtn = findViewById(R.id.stop_screen_share_btn);
mStopScreenShareBtn.setOnClickListener(v -> {
    if(mAliRtcEngine != null && mAliRtcEngine.isScreenSharePublished()) {
        mAliRtcEngine.stopScreenShare();
    }
});

6.（远端）观看屏幕共享

当用户开启屏幕共享后，频道内的其他用户会收到 onRemoteTrackAvailableNotify 回调通知。通过该回调，客户端能够实时感知远端用户音视频流的变化，包括摄像头视频流和屏幕共享视频流的发布或停止。应用可以根据回调参数动态创建或移除对应的渲染视图，实现对远端屏幕共享内容的展示与管理。

onRemoteTrackAvailableNotify 回调中，远端视频流的变化通过枚举 AliRtcVideoTrack 进行标识，具体包括：

• AliRtcVideoTrackNo (0)：无视频流，表示远端用户当前未推送任何视频流。

• AliRtcVideoTrackCamera (1)：仅推送摄像头视频流。

• AliRtcVideoTrackScreen (2)：仅推送屏幕共享视频流。

• AliRtcVideoTrackBoth (3)：同时推送摄像头和屏幕共享视频流。

应用需要通过判断该枚举值，动态调整 UI 显示逻辑，如分别显示摄像头画面和屏幕共享画面，或移除对应的视图。

private AliRtcEngineNotify mRtcEngineNotify = new AliRtcEngineNotify() {
    // 在onRemoteTrackAvailableNotify回调中设置远端视频流渲染控件
    @Override
    public void onRemoteTrackAvailableNotify(String uid, AliRtcEngine.AliRtcAudioTrack audioTrack, AliRtcEngine.AliRtcVideoTrack videoTrack){
        handler.post(new Runnable() {
            @Override
            public void run() {
                if(videoTrack == AliRtcVideoTrackCamera || videoTrack == AliRtcVideoTrackScreen) {
                    viewRemoteVideo(uid, videoTrack);
                } else if (videoTrack == AliRtcVideoTrackBoth) {
                    viewRemoteVideo(uid, AliRtcVideoTrackCamera);
                    viewRemoteVideo(uid, AliRtcVideoTrackScreen);
                } else if(videoTrack == AliRtcVideoTrackNo) {
                    removeAllRemoteVideo(uid);
                }
            }
        });
    }
}

/**
 * 显示远端流（包括摄像头流和屏幕共享流）
 * @param uid 远端用户 ID
 * @param videoTrack 视频流类型
 */
private void viewRemoteVideo(String uid, AliRtcEngine.AliRtcVideoTrack videoTrack) {
    String streamKey = getStreamKey(uid, videoTrack);
    FrameLayout view;
    if (remoteViews.containsKey(streamKey)) {
        view = remoteViews.get(streamKey);
        if (view != null) {
            view.removeAllViews();
        } else {
            view = createVideoView(streamKey);
            gridVideoContainer.addView(view);
            remoteViews.put(streamKey, view);
        }
    } else {
        view = createVideoView(streamKey);
        gridVideoContainer.addView(view);
        remoteViews.put(streamKey, view);
    }
    // 创建 SurfaceView 并设置渲染
    SurfaceView surfaceView = mAliRtcEngine.createRenderSurfaceView(this);
    surfaceView.setZOrderMediaOverlay(true);
    view.addView(surfaceView, new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
    // 配置画布
    AliRtcEngine.AliRtcVideoCanvas videoCanvas = new AliRtcEngine.AliRtcVideoCanvas();
    videoCanvas.view = surfaceView;
    mAliRtcEngine.setRemoteViewConfig(videoCanvas, uid, videoTrack);
}

/**
 * 移除指定用户视频流的画面
 * @param uid 远端用户 ID
 * @param videoTrack 视频流类型
 */
private void removeRemoteVideo(String uid, AliRtcEngine.AliRtcVideoTrack videoTrack) {
    String streamKey = getStreamKey(uid, videoTrack);

    // 找到对应的 FrameLayout 容器并移除视图
    FrameLayout frameLayout = remoteViews.remove(streamKey);
    if(frameLayout != null) {
        frameLayout.removeAllViews();
        gridVideoContainer.removeView(frameLayout);
        Log.d("RemoveRemoteVideo", "Removed video stream for: " + streamKey);
    }
}
/**
 * 移除指定用户的所有视频
 * @param uid 远端用户 ID
 */
private void removeAllRemoteVideo(String uid) {
    removeRemoteVideo(uid, AliRtcVideoTrackCamera);
    removeRemoteVideo(uid, AliRtcVideoTrackScreen);
}

7.（可选）配置屏幕共享音频音量

如果需要共享系统声音，可以调用setAudioShareVolume接口控制屏幕共享音频流的音量。

mAliRtcEngine.setAudioShareVolume(60);