进阶使用
本文主要介绍在播放器组件使用时的关键注意事项及常见问题归纳。
业务匹配
原生组件
播放器为原生组件,在其上层覆盖自定义组件(如滑动转盘、拖拽手势区域)时,手势响应区域可能超出原生组件本身,导致事件被播放器拦截,影响业务交互体验。为确保交互正常,建议在用户操作自定义组件前调用 ty.nativeDisabled(true) 暂时禁用原生组件的手势响应;操作完成后,再调用 ty.nativeDisabled(false) 恢复手势响应。 如需了解更多详情,请参考原生组件。
播放器上自定义组件
在播放器上添加可点击区域,如截图按钮、对讲按钮等等,均需使用 CoverView 组件包裹。
示例代码
样式定义
常见问题
1. 拉流播放器白屏
确认当前播放器组件容器不要设置背景色, 可参考原生组件说明
2. 视频流加载错误定位
APP 650 及以上版本, IpcPlayer 满足 >= 2.0.20 版本, 在视频流加载失败,会携带具体错误码,开发者可以根据错误码进行定位。