LOCAL_VIDEO_STREAM_REASON
LOCAL_VIDEO_STREAM_REASON
本地视频状态变化的原因。
枚举值
- 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 平台）屏幕共享时，排除窗口列表中的某些窗口排除失败。