本文介绍集成视频直播推流 SDK(Android/iOS/Flutter/Web)及播放器 SDK 时的常见问题。
AlivcLivePushInfoListener 等推流回调不触发怎么排查?
回调监听必须在调用 startPush() 之前通过 setLivePushInfoListener() 注册,推流开始后再注册将无法收到此前的事件。
使用推流 SDK 前需先调用 AlivcLiveBase.registerSDK() 注册 License,否则推流失败且回调异常。
错误事件请通过 AlivcLivePushErrorListener 监听,并可调用 getLastError() 获取最近一次错误详情。
Flutter 直播插件版本如何匹配?Demo 跑不起来怎么办?
flutter_livepush_plugin 与 flutter_aliplayer 的版本需要匹配使用(例如 7.11.0 搭配 7.11.0-interactivelive),版本不匹配会导致编译或运行失败。推荐使用 Flutter 2.8.0~3.22.2 版本区间。集成失败时,请先用官方 Demo 与推荐版本组合验证环境,再逐步替换为业务代码。
Android 推流 SDK 官方 Demo 出现 JDK 或 Gradle 版本兼容问题怎么办?
运行 Android 推流 SDK 官方 Demo 时,如果出现 JDK 或 Gradle 版本兼容问题,请按以下顺序处理:
如果 JDK 版本不兼容,将 JDK 版本降低至 17。
如果修改 JDK 后仍出现 Gradle 版本错误,将官方 Demo 工程的 Gradle 版本升级至 8.5 或 8.9。
如果无法修改官方 Demo 工程的 Gradle 版本,直接下载并使用官方提供的已打包 Demo APK 测试推流功能。
上述 Gradle 版本调整仅适用于官方 Demo 工程。自有项目集成 SDK 时,无需修改项目原有的 Gradle 版本,请保持原有配置。
播放器 SDK 支持哪些 Android 系统版本?低版本黑屏怎么排查?
视频直播播放器 SDK 支持 Android 9 及以上系统。低版本 Android 或老旧机型出现黑屏,通常并非系统版本过低导致,而可能是老旧机型对 H.265 硬解支持不完善,或渲染 View 初始化时序敏感所致。
请重点排查设备的 H.265 硬解能力,以及渲染 View 初始化时序。
AliPlayer SDK 为什么在 arm64 模拟器上链接失败?
AliPlayer SDK 目前不支持在 arm64 模拟器上运行,因此会导致链接失败。请使用真机或其他受支持的模拟器架构测试。
推流/预览中可以动态切换横竖屏吗?
不支持在预览或推流过程中动态切换横竖屏。屏幕方向需在开始预览/推流前通过 setPreviewOrientation 设置;如需切换方向,应先 stopPreview 再重新 startPreview。横屏推流出现画面拉伸时,可在方向设置完成后延迟约 100 毫秒再调用 startPreview。
跨平台框架(Flutter、UniApp 等)下横竖屏设置无效时,还需额外确认以下两点:
硬编码模式下,推流分辨率的宽高需设置为 16 的整数倍,否则可能出现画面拉伸或编码失败。
预览视图与播放视图不可混用:推流预览需使用推流 SDK 提供的预览视图类型,播放则使用播放器自身的视图,混用会导致画面异常或无法渲染。
直播互动消息支持哪些平台?有 Flutter SDK 吗?
直播互动消息(IM)目前支持 Android、iOS、微信小程序、Web H5(可配合 uni-app 使用),不提供 Flutter SDK。Flutter 应用如需互动消息能力,可通过原生插件桥接方式自行封装集成。
Flutter 推流 SDK 设置配置参数时是否需要使用 await 等待?
不需要。设置 pusherConfig 配置参数以及调用相关方法时,均不需要使用 await 等待。
Android 推流 SDK如何切换或调整预览视图?
设置预览显示模式:可以通过
mAlivcLivePushConfig.setPreviewDisplayMode()方法设置预览显示模式,支持铺满窗口、保持比例、裁剪适配三种模式。推流中动态调整预览视图:若需在推流过程中动态更改预览视图,可以调整预览 View 的子视图布局来实现,例如遍历
startPreview时传入的SurfaceView的所有subView并修改其 frame。
推流 Demo 应用安装后无法使用怎么办?
先确认手机系统是否允许安装未知来源应用,未开启权限时可能安装不完整、安装后无法正常启动。
基础版与互动版是两个独立的安装包,功能范围不同,需根据要验证的场景分别安装,不能互相替代。
若仍异常,请从帮助文档重新下载最新安装包覆盖安装,并确认设备系统版本在 SDK 支持范围内。