You need to enable JavaScript to run this app. Android Studio Java开发使用Vonage API屏幕共享失效,输出摄像头画面且咨询配置要求
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio Java开发使用Vonage API屏幕共享失效,输出摄像头画面且咨询配置要求

Android端Vonage屏幕共享功能异常排查与配置说明

核心功能异常排查(推流为摄像头内容而非屏幕采集内容)

  • Publisher初始化顺序错误是当前代码的核心问题
    现有代码流程为:先构建默认Publisher实例 -> 构建完成后再调用setCapturer替换捕获器。Vonage的Publisher在Builder.build()阶段会自动初始化默认的摄像头视频捕获器,build完成后再替换Capturer的操作,无法完全注销已经初始化好的摄像头采集流程,最终导致推流时优先输出已经启动的摄像头采集内容,而非新设置的屏幕捕获器内容。
    现有错误流程对应代码片段:
    // 错误实现:先完成默认实例构建,再替换捕获器
    mPublisher = new Publisher.Builder(MainActivity.this).name("publisher").build();
    mPublisher.setPublisherVideoType(PublisherKit.PublisherKitVideoType.PublisherKitVideoTypeScreen);
    // build完成后设置的Capturer无法覆盖已初始化的摄像头采集逻辑
    mPublisher.setCapturer(screenCapturer);
    
    正确的实现逻辑为:在Builder构建Publisher的阶段就传入自定义屏幕捕获器,跳过默认摄像头捕获器的初始化流程:
    // 正确实现:构建阶段直接指定屏幕捕获器
    mPublisher = new Publisher.Builder(MainActivity.this)
        .name("screen_publisher")
        .capturer(screenCapturer)
        .build();
    mPublisher.setPublisherVideoType(PublisherKit.PublisherKitVideoType.PublisherKitVideoTypeScreen);
    
  • 自定义捕获器生命周期校验
    需确认自研的ScreenSharingCapturer类完整实现BaseVideoCapturer的所有回调方法,尤其是在onStartCapture回调中,需先完成摄像头采集逻辑的强制停止、再启动屏幕帧捕获流程,避免双捕获源同时运行时摄像头流抢占推流通道。
  • 系统权限校验
    检查是否已完成MediaProjection的用户授权流程、是否声明了FOREGROUND_SERVICE_MEDIA_PROJECTION前台服务权限。若授权流程未正确传递给屏幕捕获器,SDK会自动回退到默认摄像头采集逻辑进行推流。

屏幕共享场景的配置权限说明

  • 无需为屏幕共享单独申请独立API密钥,API密钥与普通视频通话场景通用,不存在场景级别的权限隔离。
  • 无需为屏幕共享创建独立会话ID,屏幕共享的Publisher可以和普通摄像头Publisher发布在同一个会话中,SDK会通过PublisherKitVideoType字段自动区分流类型,接收端可基于该字段做差异化的渲染控制。
  • 仅需根据屏幕内容的分辨率调整对应发布流的码率参数,无需修改鉴权、会话创建的核心流程。

内容的提问来源于stack exchange,提问作者Apurba A

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 01:36:04