iOS App 基座执行 plus.video.createLivePusher 闪退问题排查指南

iOS App 基座执行 plus.video.createLivePusher 闪退问题排查指南
一、常见原因分析
权限配置问题

相机/麦克风权限未声明

Info.plist 缺少必要权限描述（iOS 10+ 强制要求）

用户首次使用时拒绝了权限请求

**SDK 集成问题

原生直播推流 SDK 未正确集成

第三方库版本冲突

未正确配置依赖库（如 FFmpeg）

API 调用问题

参数格式错误

在非主线程调用 UI 相关 API

未正确处理异步回调

二、详细排查步骤

1. 检查基础配置
   xml
   <!-- Info.plist 必须包含 -->
   <key>NSCameraUsageDescription</key>
   <string>需要摄像头权限进行直播</string>
   <key>NSMicrophoneUsageDescription</key>
   <string>需要麦克风权限进行直播</string>
2. 验证权限状态（Swift示例）
   swift
   AVCaptureDevice.requestAccess(for: .video) { granted in
   if !granted {
   print("摄像头权限被拒绝")
   }
   }
3. 检查控制台日志
   连接Xcode查看崩溃堆栈

过滤关键字："LivePusher"、"EXC_BAD_ACCESS"、"signal SIGABRT"

1. 最小化测试代码
   javascript
   // 测试基础调用
   const pusher = plus.video.createLivePusher({
   url: 'rtmp://test.url',
   top: '0px',
   left: '0px',
   width: '100%',
   height: '100%'
   })
   三、高级调试方案
   符号化崩溃日志

使用 atos 命令解析堆栈地址

示例：atos -arch arm64 -o YourApp.app/YourApp 0x00000001000a1234

设备日志分析

bash
idevicesyslog | grep YourAppBundleID
内存诊断

开启Zombie Objects检测

使用Instruments检查内存泄漏

四、特定场景解决方案
案例1：后台切回时闪退

javascript
// 添加生命周期监听
document.addEventListener('pause', () => {
pusher.close()
})
document.addEventListener('resume', () => {
pusher.resume()
})
案例2：特定机型崩溃

检查GPU兼容性

测试关闭硬件加速：

javascript
plus.video.createLivePusher({
hardwareAcceleration: false
// 其他参数...
})
五、终极排查清单
确认所有必要权限已声明

验证SDK版本兼容性

检查参数格式符合文档要求

确保在主线程调用UI相关API

测试基础配置是否能正常运行

收集完整的崩溃日志和堆栈信息

建议按照以上步骤逐步排查，如果问题仍未解决，可提供以下信息进一步分析：

完整的崩溃日志

使用的SDK版本号

复现设备型号和iOS版本

最小化复现代码片段

https://q.yingjiesheng.com/forum/bk25786/tz1126143
https://q.yingjiesheng.com/forum/bk25786/tz1126144
https://q.yingjiesheng.com/forum/bk25786/tz1126145
https://q.yingjiesheng.com/forum/bk25786/tz1126147
https://q.yingjiesheng.com/forum/bk25786/tz1126148
https://q.yingjiesheng.com/forum/bk25786/tz1126149
https://q.yingjiesheng.com/forum/bk25786/tz1126150
https://q.yingjiesheng.com/forum/bk25786/tz1126151
https://q.yingjiesheng.com/forum/bk25786/tz1126152
https://q.yingjiesheng.com/forum/bk25786/tz1126153
https://q.yingjiesheng.com/forum/bk25786/tz1126154
https://q.yingjiesheng.com/forum/bk25786/tz1126155
https://q.yingjiesheng.com/forum/bk25786/tz1126156
https://q.yingjiesheng.com/forum/bk25786/tz1126157
https://q.yingjiesheng.com/forum/bk25786/tz1126158
https://q.yingjiesheng.com/forum/bk25786/tz1126159
https://q.yingjiesheng.com/forum/bk25786/tz1126160
https://q.yingjiesheng.com/forum/bk25786/tz1126161
https://q.yingjiesheng.com/forum/bk25786/tz1126162
https://q.yingjiesheng.com/forum/bk25786/tz1126163
https://q.yingjiesheng.com/forum/bk25786/tz1126164
https://q.yingjiesheng.com/forum/bk25786/tz1126165
https://q.yingjiesheng.com/forum/bk25786/tz1126166
https://q.yingjiesheng.com/forum/bk25786/tz1126167
https://q.yingjiesheng.com/forum/bk25786/tz1126168
https://q.yingjiesheng.com/forum/bk25786/tz1126169
https://q.yingjiesheng.com/forum/bk25786/tz1126170
https://q.yingjiesheng.com/forum/bk25786/tz1126171
https://q.yingjiesheng.com/forum/bk25786/tz1126172
https://q.yingjiesheng.com/forum/bk25786/tz1126173
https://q.yingjiesheng.com/forum/bk25786/tz1126174
https://q.yingjiesheng.com/forum/bk25786/tz1126175
https://q.yingjiesheng.com/forum/bk25786/tz1126176
https://q.yingjiesheng.com/forum/bk25786/tz1126177
https://q.yingjiesheng.com/forum/bk25786/tz1126178
https://q.yingjiesheng.com/forum/bk25786/tz1126179
https://q.yingjiesheng.com/forum/bk25786/tz1126180
https://q.yingjiesheng.com/forum/bk25786/tz1126181
https://q.yingjiesheng.com/forum/bk25786/tz1126183
https://q.yingjiesheng.com/forum/bk25786/tz1126184
https://q.yingjiesheng.com/forum/bk25786/tz1126185
https://q.yingjiesheng.com/forum/bk25786/tz1126186
https://q.yingjiesheng.com/forum/bk25786/tz1126187
https://q.yingjiesheng.com/forum/bk25786/tz1126188
https://q.yingjiesheng.com/forum/bk25786/tz1126189
https://q.yingjiesheng.com/forum/bk25786/tz1126190
https://q.yingjiesheng.com/forum/bk25786/tz1126191
https://q.yingjiesheng.com/forum/bk25786/tz1126192
https://q.yingjiesheng.com/forum/bk25786/tz1126193
https://q.yingjiesheng.com/forum/bk25786/tz1126194
https://q.yingjiesheng.com/forum/bk25786/tz1126195
https://q.yingjiesheng.com/forum/bk25786/tz1126196
https://q.yingjiesheng.com/forum/bk25786/tz1126197
https://q.yingjiesheng.com/forum/bk25786/tz1126198
https://q.yingjiesheng.com/forum/bk25786/tz1126199
https://q.yingjiesheng.com/forum/bk25786/tz1126200
https://q.yingjiesheng.com/forum/bk25786/tz1126201
https://q.yingjiesheng.com/forum/bk25786/tz1126202
https://q.yingjiesheng.com/forum/bk25786/tz1126203
https://q.yingjiesheng.com/forum/bk25786/tz1126204
https://q.yingjiesheng.com/forum/bk25786/tz1126205
https://q.yingjiesheng.com/forum/bk25786/tz1126206
https://q.yingjiesheng.com/forum/bk25786/tz1126207
https://q.yingjiesheng.com/forum/bk25786/tz1126208
https://q.yingjiesheng.com/forum/bk25786/tz1126209
https://q.yingjiesheng.com/forum/bk25786/tz1126210
https://q.yingjiesheng.com/forum/bk25786/tz1126211
https://q.yingjiesheng.com/forum/bk25786/tz1126212
https://q.yingjiesheng.com/forum/bk25786/tz1126213
https://q.yingjiesheng.com/forum/bk25786/tz1126214
https://q.yingjiesheng.com/forum/bk25786/tz1126215
https://q.yingjiesheng.com/forum/bk25786/tz1126216
https://q.yingjiesheng.com/forum/bk25786/tz1126217
https://q.yingjiesheng.com/forum/bk25786/tz1126218
https://q.yingjiesheng.com/forum/bk25786/tz1126219
https://q.yingjiesheng.com/forum/bk25786/tz1126220
https://q.yingjiesheng.com/forum/bk25786/tz1126221
https://q.yingjiesheng.com/forum/bk25786/tz1126222
https://q.yingjiesheng.com/forum/bk25786/tz1126223
https://q.yingjiesheng.com/forum/bk25786/tz1126224
https://q.yingjiesheng.com/forum/bk25786/tz1126225
https://q.yingjiesheng.com/forum/bk25786/tz1126226
https://q.yingjiesheng.com/forum/bk25786/tz1126227
https://q.yingjiesheng.com/forum/bk25786/tz1126228
https://q.yingjiesheng.com/forum/bk25786/tz1126229
https://q.yingjiesheng.com/forum/bk25786/tz1126230
https://q.yingjiesheng.com/forum/bk25786/tz1126231
https://q.yingjiesheng.com/forum/bk25786/tz1126232
https://q.yingjiesheng.com/forum/bk25786/tz1126233
https://q.yingjiesheng.com/forum/bk25786/tz1126234
https://q.yingjiesheng.com/forum/bk25786/tz1126235
https://q.yingjiesheng.com/forum/bk25786/tz1126236
https://q.yingjiesheng.com/forum/bk25786/tz1126237