iOS播放器-2.0-上线公告及老用户迁移问题
更新时间:2019-06-14
2.0 新版SDK在设计时,与1.0 版本SDK及MPMoviePlayerController
接口高度一致,尽可能降低用户迁移的成本。但也还是会或多或少引入一些差异。下列是主要变更点:
同时,2.0 新版SDK中也附带了demo,方便老用户参考迁移。
命名变化
2.0 新版SDK中的类名均以“百度智能云”品牌的缩写BDCloud
开头。
1.0 版SDK中的类名均以Cyber
开头。
单位变化
获取下载速度接口downloadSpeed
的单位从 KBps 变为Bps。
接口变化
原接口(1.0) | 新接口(2.0) | 说明 |
---|---|---|
字幕相关 | - | 新版SDK不支持字幕相关功能 |
start | - | 新版SDK中使用play 代替 |
setAccessKey: | 类BDCloudMediaPlayerAuth | 新版SDK中使用类BDCloudMediaPlayerAuth 进行鉴权 |
getSupportedResolution | getSupportedBitrates | 新版SDK中getSupportedResolution 的功能合并到getSupportedBitrates 方法中 |
getBitrateIndex | bitrateIndex | - |
selectBitrate: | setBitrateIndex: | - |
getCurrentPlayingUrl | - | 已删除 |
snapshot | thumbnailImageAtCurrentTime | - |
dolbyEnabled | - | 已删除 |
scalingMode | scalingMode | 新版SDK去掉了 5:4 4:3 16:9缩放模式 |
videoHeight | - | 已删除,通过naturalSize 获取 |
videoWidth | - | 已删除,通过naturalSize 获取 |
shouldAutoClearRender | - | 已删除 |
shouldPauseCaching | - | 已删除 |
infoDuration | - | 已删除 |
accurateSeeking | - | 已删除 |
accuratePostion | - | 已删除 |
cachePauseTimeInSeconds | setCachePauseTime | - |
firstBufferingTimeInSeconds | setFirstBufferingTime | - |
通知变化
原通知(1.0) | 新通知(2.0) |
---|---|
CyberPlayerStartCachingNotification | 原通知拆分为两个通知: BDCloudMediaPlayerBufferingStartNotification BDCloudMediaPlayerBufferingEndNotification |
CyberPlayerGotCachePercentNotification | BDCloudMediaPlayerBufferingUpdateNotification 用BDCloudMediaPlayerBufferingProgressUserInfoKey 获取缓冲进度 用 BDCloudMediaPlayerBufferingPositionUserInfoKey 获取缓冲位置 |
CyberPlayerPlaybackErrorNotification | 合并到BDCloudMediaPlayerPlaybackDidFinishNotification 中 用 BDCloudMediaPlayerPlaybackDidFinishReasonUserInfoKey 获取结束原因 |
CyberPlayerSeekingDidFinishNotification | BDCloudMediaPlayerPlaybackStateDidChangeNotification playbackState 从 BDCloudMediaPlayerPlaybackStateSeekingForward 或者BDCloudMediaPlayerPlaybackStateSeekingBackward 变更到 BDCloudMediaPlayerPlaybackStatePlaying |
CyberPlayerGotNetworkBitrateNotification | 播放中定时获取属性downloadSpeed |
CyberPlayerCurrentPositionNotification | 播放中定时获取属性currentPlaybackTime |
迁移FAQ
支持多实例
- 1.0 版不支持多实例,这需要等待旧的实例释放完成后,才能创建新的实例。
- 2.0 新版已经支持多实例,不同实例之间互不影响。
更好的解码性能
- 1.0 版仅能使用软解;新版支持硬解。
- 2.0 新版的解码模式默认为AUTO(即优先硬解,硬解不成功时自动转为软解)。如果您想一直使用软解,可以通过
setVideoDecodeMode
接口设置。
支持倍速播放
新版SDK支持设置播放速率playbackRate
。
支持设置水印
新版SDK增加了对水印的支持,客户可以设置水印图片和水印位置。
支持接入APM
APM SDK 提供数据监控、发送、后台报表处理与展示能力。实时性强,能够及时上报用户在点播、直播中的卡顿、网速等信息,方便运营方及时调整策略和调度。
2.0 新版SDK不直接依赖APM SDK
, 在运行时动态检查App是否接入了APM SDK
。
迁移中遇到问题,请联系我们
原百度智能云播放器iOS SDK 1.0 帮助文档请参考iOS SDK 1.0。