美洽线上课程无法观看时如何收集设备与报错信息？

请按下列步骤快速收集美洽线上课程无法观看时的设备与报错信息：记录设备型号与系统版本、浏览器及扩展、网络类型与带宽、控制台与网络日志、屏幕录像与截图，并附上重现步骤、时间戳与会话ID，说明是否使用VPN或代理，整理后一并提交给美洽技术支持以便快速定位与处理问题。

美洽播放器基本问题排查

执行基础重启并复现问题

• 重启设备：先完整重启电脑或手机，再打开美洽重新进入课程页面进行一次完整复现，记录复现前后是否有差异、复现步骤和复现时间以便关联日志。
• 重启网络设备：尝试重启路由器和调制解调器，重启后再次测试美洽播放，记录网络重连时间、WAN公网IP和是否仍然存在卡顿或无法加载的问题。
• 切换网络环境：若可能切换为手机热点或另一Wi‑Fi进行测试，记录两类网络下的行为差异及所用运营商、网络类型（例如4G/5G/Wi‑Fi）和信号强度。

检查播放器的错误提示并截图保存

• 截取错误提示：对出现的任何提示框、错误码或黑屏信息进行截图或截屏，务必同时记录出现时的页面URL、时间戳和进行的操作步骤以便复现。
• 记录错误码文本：若播放器或页面显示错误码或提示文字，请完整复制错误文本与编号，说明出现频率、是否偶发以及是否伴随其他异常音视频问题。
• 拍摄实际现象：如果是闪烁、卡顿或花屏等视觉问题，建议录制短视频示例并备注开始与结束时间点，以便工程师观察帧率和画面异常。

美洽设备信息采集步骤

记录设备型号与系统版本

• 记录设备与系统：在“关于本机”或设置中抄下设备型号、制造商、系统版本号、内核或构建号，移动设备请写明Android/iOS具体版本与固件或补丁级别。
• 标注是否越狱或获取root：说明设备是否被越狱或已取得root权限，因为这类情况可能造成权限或多媒体组件异常，附上相关状态说明便于排查。
• 记录设备性能信息：说明CPU类型、内存大小与可用空间情况，若设备内存不足、存储占用高或CPU温度异常，都可能导致播放失败请一并记录。

获取浏览器或客户端版本信息

• 记录浏览器名称与版本：在浏览器“关于”页复制完整版本信息，若使用美洽客户端则在帮助或关于中抄下版本号与构建时间，便于确认兼容性问题。
• 列出已安装插件或扩展：说明是否安装广告拦截、隐私保护或安全类扩展以及是否启用这些扩展，因插件冲突常导致脚本或媒体资源被阻止。
• 说明是否使用特殊浏览器设置：如启用代理、隐私模式、禁用第三方Cookie、关闭WebRTC或开启增强安全模式，均会影响美洽播放功能。

美洽网络与带宽检测方法

测量上下行带宽与延迟

• 进行速度测试：使用Speedtest或同类工具测量上下行带宽和延迟，记录测试时间、测试节点与结果截图，并说明是否同时有其他设备占用大量带宽。
• 多次测试并记录波动：在不同时间点进行至少三次测试以观察带宽波动情况，记录最低值、平均值和峰值以便判断是否为网络不稳定所致。
• 记录丢包率和抖动：通过ping外网（如ping 8.8.8.8）或traceroute记录丢包率和抖动情况，若发现高丢包或跳点异常请保存完整输出。

检测NAT、代理与VPN影响

• 说明是否使用VPN或代理：如使用VPN、公司代理或校园网，请说明服务提供商、服务器位置和是否为全局代理，以判断可能的连接或路径被干扰问题。
• 检查NAT类型与端口限制：在路由器或防火墙中查看NAT类型和端口转发设置，若存在严格NAT或端口限制可能影响WebRTC或流媒体回连功能。
• 提供路由追踪结果：执行traceroute/路径跟踪并保存结果，若存在跨国或长路径延迟以及某个跳点丢包严重，请一并提交以便排查运营商路由问题。

美洽浏览器与系统设置调整

收集浏览器控制台与网络日志（HAR）

• 导出控制台错误：打开开发者工具(Console)并保留日志，复现问题后复制或保存错误堆栈与时间标记，错误信息与堆栈是定位脚本或媒体错误的关键。
• 生成并保存HAR文件：在Network标签开启记录，刷新并复现问题后导出HAR文件，确保包含请求头、响应码和时间线，这对分析资源加载与跨域错误非常重要。
• 记录媒体请求与响应码：在网络日志中关注视频分段、MSE、HLS或DASH的请求响应码、Content‑Type与大小，若存在大量4xx/5xx或长时间pending需截取示例请求。

使用WebRTC或系统日志获取更多信息

• 导出WebRTC内部统计：在支持的浏览器中打开about:webrtc或chrome://webrtc‑internals并复现保存日志，导出getStats、SDP和连接事件以便分析媒体协商问题。
• 获取系统级日志：在Windows使用事件查看器导出相关时间段日志，macOS使用Console导出日志，移动设备可收集Android logcat或iOS sysdiagnose以便定位底层错误。
• 记录音视频设备授权状态：说明浏览器是否已获得摄像头/麦克风权限，并在控制台/浏览器权限项中截屏或记录权限状态与任何拒绝提示信息以便判定权限问题。

美洽错误日志与截图提交指南

准备和命名所有附件以便关联

• 统一命名规则：将截图、视频、HAR、控制台日志和系统日志按“日期_时间_会话ID_类型”命名，例如“20261025_1530_ABC123_HAR.har”，便于支持团队快速关联与检索。
• 压缩并保留原始：将所有文件压缩为ZIP并保留原始未编辑的副本，若附件较大请使用云盘共享并提供下载链接，同时注明下载有效期与访问权限。
• 附上文本说明：在提交工单或邮件正文中简要列出重现步骤、时间点、是否使用VPN、设备型号与浏览器版本等关键信息，便于工程师优先定位问题。

发送给美洽支持并提供优先级信息

• 提交工单要点：在美洽支持渠道填写工单时，确保填写会话ID、课堂ID、复现时间、用户账号、附件链接和是否为所有用户或仅个别用户出现，明确问题优先级。
• 说明影响范围与紧急程度：说明该问题是否影响全部学员或特定网络/设备组，若影响到直播或重要教学请标注为紧急并在工单中说明期望处理时限。
• 保留沟通记录：保存与支持的每次交流记录和工单编号，若工程师要求提供补充信息请及时响应并附上新日志或复现视频以加快问题闭环。

常见问题与答案（FAQ）

• 问：美洽播放黑屏但声音有怎么办？ 答：先检查视频解码器与硬件加速设置，尝试在浏览器设置中关闭硬件加速并清除缓存；若仍然存在请提交控制台日志和截图。
• 问：如何导出浏览器的HAR文件？ 答：打开开发者工具(Network)，勾选“Preserve log”，复现问题后右键选择“Save all as HAR with content”并保存上传给美洽支持。
• 问：移动端无法播放如何提供日志？ 答：对Android请使用adb logcat收集日志并导出相关时间段；iOS可使用Xcode设备日志或sysdiagnose，若不便操作请提供屏幕录制与系统信息截屏。
• 问：提交的文件太大怎么办？ 答：将日志与录屏压缩为ZIP后上传至常用云盘并将分享链接附在工单中，或与美洽支持协商使用专用上传通道以确保传输成功。