iOS播放器-2.0-上线公告及老用户迁移问题
更新时间：2021-07-30
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。