LOCAL_VIDEO_STREAM_REASON

  • C++

更新时间不可用

本地视频状态变化的原因。

枚举值

参数名描述
LOCAL_VIDEO_STREAM_REASON_OK

(0):本地视频状态正常。

LOCAL_VIDEO_STREAM_REASON_FAILURE

(1):本地视频出现异常,未指定具体原因。

LOCAL_VIDEO_STREAM_REASON_DEVICE_NO_PERMISSION

(2):无权限使用本地视频采集设备。请提示用户授予权限并重新加入频道。

LOCAL_VIDEO_STREAM_REASON_DEVICE_BUSY

(3):本地视频采集设备被占用。请提示用户检查摄像头是否被其他应用占用,或尝试重新加入频道。

LOCAL_VIDEO_STREAM_REASON_CAPTURE_FAILURE

(4):本地视频采集失败。请提示用户检查视频采集设备是否正常工作,摄像头是否被其他应用占用,或尝试重新加入频道。

LOCAL_VIDEO_STREAM_REASON_CODEC_NOT_SUPPORT

(5):本地视频编码失败。

LOCAL_VIDEO_STREAM_REASON_CAPTURE_INBACKGROUND

(6):(仅适用于 iOS 平台)应用处于后台状态。请提示用户,应用在后台时无法正常采集视频。

LOCAL_VIDEO_STREAM_REASON_CAPTURE_MULTIPLE_FOREGROUND_APPS

(7):(仅适用于 iOS 平台)当前应用窗口处于 Slide Over、Split View 或画中画模式,且摄像头被其他应用占用。请提示用户,在上述模式下若摄像头被其他应用占用,应用将无法正常采集视频。

LOCAL_VIDEO_STREAM_REASON_DEVICE_NOT_FOUND

(8):未找到本地视频采集设备。请提示用户检查摄像头是否正确连接或正常工作,并重新加入频道。

LOCAL_VIDEO_STREAM_REASON_DEVICE_DISCONNECTED

(9):(仅适用于 macOS 和 Windows 平台)当前使用的视频采集设备已断开连接(例如被拔出)。

LOCAL_VIDEO_STREAM_REASON_DEVICE_INVALID_ID

(10):(仅适用于 macOS 和 Windows 平台)SDK 在视频设备列表中找不到该视频设备。请检查视频设备的 ID 是否有效。

LOCAL_VIDEO_STREAM_REASON_DEVICE_INTERRUPT

(14):(仅适用于 Android 平台)视频采集被中断。可能原因包括:摄像头被其他应用占用;当前应用切换到后台。你可以使用前台服务通知操作系统,确保应用切换到后台后仍能采集视频。

LOCAL_VIDEO_STREAM_REASON_DEVICE_FATAL_ERROR

(15):(仅适用于 Android 平台)视频采集设备发生错误。请提示用户关闭并重启摄像头以恢复功能。如果问题仍未解决,请检查摄像头是否存在硬件故障。

LOCAL_VIDEO_STREAM_REASON_DEVICE_SYSTEM_PRESSURE

(101):当前视频采集设备因系统压力过大而不可用。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_WINDOW_MINIMIZED

(11):(仅适用于 macOS 和 Windows 平台)调用 startScreenCaptureByWindowId 方法共享窗口时,被共享窗口已最小化。SDK 无法共享最小化的窗口。请提示用户取消最小化该窗口。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_WINDOW_CLOSED

(12):(仅适用于 macOS 和 Windows 平台)被共享的窗口已关闭,或全屏窗口退出了全屏模式。退出全屏后,远端用户将无法看到共享窗口。为避免远端用户看到黑屏,建议立即停止屏幕共享。常见场景包括:本地用户关闭共享窗口;本地用户先全屏播放幻灯片再共享幻灯片窗口,退出全屏后触发该错误码;本地用户先全屏观看网页视频或文档再共享其窗口,退出全屏后触发该错误码。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_WINDOW_OCCLUDED

(13):(仅适用于 Windows 平台)被共享的窗口被其他窗口遮挡,SDK 会将被遮挡区域置黑。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_WINDOW_NOT_SUPPORTED

(20):不支持本地屏幕共享窗口。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_FAILURE

(21):(仅适用于 Windows 和 Android 平台)当前被采集的窗口无数据。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_NO_PERMISSION

(22):(仅适用于 Windows 和 macOS 平台)无屏幕共享权限。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_AUTO_FALLBACK

(24):(仅适用于 Windows 平台)屏幕共享过程中发生异常错误(可能由于窗口遮挡失败),导致性能下降,但屏幕共享过程本身未受影响。

注: 在屏幕共享过程中,如果由于设备驱动问题导致遮挡特定窗口失败,SDK 会上报此事件并自动回退为共享整个屏幕。如果你的使用场景需要遮挡特定窗口以保护隐私,建议监听此事件并在触发时实现额外的隐私保护机制。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_WINDOW_HIDDEN

(25):(仅适用于 Windows 平台)当前屏幕共享的窗口被隐藏,在当前屏幕上不可见。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_WINDOW_RECOVER_FROM_HIDDEN

(26):(仅适用于 Windows 平台)屏幕共享的窗口已从隐藏状态恢复。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_WINDOW_RECOVER_FROM_MINIMIZED

(27):(仅适用于 macOS 和 Windows 平台)屏幕共享的窗口已从最小化状态恢复。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_PAUSED

(28):(仅适用于 Windows 平台)屏幕共享已暂停。常见场景包括:当前屏幕切换到安全桌面,例如 UAC 对话框或 Winlogon 桌面。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_RESUMED

(29):(仅适用于 Windows 平台)屏幕共享已从暂停状态恢复。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_DISPLAY_DISCONNECTED

(30):(仅适用于 Windows 和 macOS 平台)用于屏幕共享的显示器已断开连接,当前屏幕共享已暂停。请提示用户重新开始屏幕共享。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_STOPPED_BY_USER

(31):(仅适用于鸿蒙平台)屏幕共享被用户停止。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_INTERRUPTED_BY_OTHER

(32):(仅适用于鸿蒙平台)屏幕共享被其他屏幕共享中断。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_STOPPED_BY_CALL

(33):(仅适用于鸿蒙平台)屏幕共享因 SIM 通话被停止。

LOCAL_VIDEO_STREAM_REASON_SCREEN_CAPTURE_EXCLUDE_WINDOW_FAILED

(34):(仅适用于 Windows 平台)屏幕共享时,排除窗口列表中的部分窗口排除失败。

表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?