本文提供快速集成iOS播放器SDK的指引。
环境要求
类别 | 说明 |
---|---|
系统版本 | 支持iOS 8.0及以上版本。 |
开发工具 | 建议使用Xcode,本文操作步骤基于Xcode开发。下载地址:Xcode。 |
前提条件
本地集成SDK时,需要先下载iOS播放器SDK包(包含了iOS播放器SDK及Demo源码),推荐下载使用最新版本。下载地址请参见播放器SDK。
解压后的目录结构如下:
文件名 | 作用 |
---|---|
demo | iOS播放器SDK的Demo源码。 |
doc | iOS播放器SDK接口文档。 |
sdk | iOS播放器SDK的framework库,只提供了包含bitcode和模拟器的ARM_SIMULATOR文件夹,如果需要不包含bitcode或模拟器的包,请参考以下命令另行下载。
|
ReleaseNote | 版本说明。 |
sdk文件夹下各文件说明如下:
文件名 | 说明 |
---|---|
ARM | 带bitcode,不包括模拟器。 |
ARM_NO_BITCODE | 不带bitcode,不包括模拟器。 |
ARM_SIMULATOR | 带bitcode,带模拟器。 |
ARM_SIMULATOR_NO_BITCODE | 不带bitcode,包含i386 x86_64 armv7 arm64架构。 |
重要 模拟器用于代码调试,发布时,不能使用带模拟器的版本,否则会提交AppStore失败。
Framework说明如下:
Framework | 说明 |
---|---|
alivcffmpeg.framework | 播放器底层,必须。 |
AliyunMediaDownloader.framework | 用于离线下载,非必须。 |
AliyunPlayer.framework | 播放器,必须。 |
artcSource.framework | 支持artc协议,非必须。 |
artpSource.framework | 支持artp协议,非必须。在5.4.5.0版本已经移除了对它的依赖。 |
RtsSDK.framework | 超低延时直播,非必须。 |
AlivcConan | 在5.3.0版本已经移除了对它的依赖。 |
说明
- 在进行打包时,dSYM文件用于crash符号表解析。
- 使用时,alivcffmpeg和AliyunPlayer都是必需的,缺一不可。播放器头文件位于AliyunPlayer。
SDK集成(cocoapods集成)(推荐)
说明 如需同时集成播放器SDK和短视频SDK,将下面代码中的AliPlayerSDK_iOS替换成AliPlayerPartSDK_iOS。AliPlayerPartSDK_iOS不包含ffmpeg,避免了与短视频SDK中的ffmpeg的冲突。
SDK集成(本地集成)
说明 如果您的代码或引用的第三方代码,与alivcffmpeg或AlivcConan的symbol有冲突,可以将alivcffmpeg或AlivcConan从Linked
Frameworks and Libraries里删除,app link时可以不依赖这两个framework。AlivcConan从5.3.0版本开始不再需要依赖。
配置License
说明
- V5.4.7.1及之后版本的iOS播放器SDK必须按以下操作配置License后,方可使用。
- License配置完成后,查看日志若无License相关报错,则表示License配置成功。