集成iOS端播放器SDK

环境要求

前提条件

• 已注册并获取包含播放器授权的License文件AliVideoCert-********.crt。具体操作，请参见管理License。

• 本地集成SDK时，需要先下载iOS端播放器SDK包（包含了iOS端播放器SDK及Demo源码），推荐下载使用最新版本。下载地址请参见播放器SDK。

cd $(SDK_PATH) //SDK_PATH：SDK所在路径
sh createMoreKindsOfArch.sh

注意事项

• 在进行打包时，dSYM文件用于crash符号表解析。

• 使用iOS端播放器SDK时，AlivcFFmpeg和AliyunPlayer都是必需的，缺一不可。播放器头文件位于AliyunPlayer。

• 如需同时集成播放器SDK和短视频SDK，则需要关注短视频SDK、播放器SDK及AlivcFFmpeg的版本依赖关系，否则会导致短视频或播放器的功能使用失败，详细信息，请参见AlivcFFmpeg版本依赖。

• iOS端播放器SDK在模拟器上调试不能保证所有功能的正常运行，建议iOS端播放器SDK集成完成后使用真机进行运行调试。

• iOS端播放器SDK提供的安装包中包含了模拟器，模拟器可用于代码调试，发布时，不能包含模拟器，否则会提交AppStore失败。

SDK集成（cocoapods集成）（推荐）

1. 采用pod语句集成播放器SDK，示例代码如下：

   说明

   如需同时集成播放器SDK和短视频SDK，将下面代码中的AliPlayerSDK_iOS替换成AliPlayerPartSDK_iOS，AliPlayerPartSDK_iOS不包含ffmpeg，可以避免与短视频SDK中的ffmpeg冲突。

   ruby
    platform:ios, '8.0'
    target 'yourProject' do
    pod 'AliPlayerSDK_iOS'
    end

2. 可选：如果需要支持artc协议或播放超低延时直播（RTS）流，请添加以下pod依赖，示例代码如下：

   说明

   请确保引入的播放器SDK版本号填写正确，否则将报错并引入失败。

   ruby
    platform:ios, '8.0'
    target 'yourProject' do
    pod 'AliPlayerSDK_iOS', '5.4.7.1'
    pod 'AliPlayerSDK_iOS_ARTC', '5.4.7.1'
    pod 'RtsSDK', '2.2.0' //此处版本仅供参考，获取最新RTS SDK的版本请参见超低延时直播SDK下载。
    end

SDK集成（本地集成）

1. 在Xcode工程中，单击General页签。

2. 将SDK的framework添加到Frameworks，Libraries，and Embedded Content中，并将Embed设置为Embed & Sign。

   

3. 单击Build Settings页签。

4. 单击Search Paths区域下的Framework Search Paths，修改为本地framework所在的目录。

配置License

1. 在Xcode工程里，通过Build Phases > Copy Bundle Resources，将获取到的证书文件AliVideoCert-********.crt拷贝到Xcode的项目中，建议放到AppSupportFiles目录下，也可以放到沙箱或者其他路径。

2. 在Info.plist文件中添加如下字段。

   

   • key为AlivcLicenseKey，value为LicenseKey的值。

   • key为AlivcLicenseFile，value为步骤二中证书文件的放置路径，请根据实际情况填写。

    <key>AlivcLicenseKey</key>
    <string>Wo8s*******************</string>
    <key>AlivcLicenseFile</key>
    <string>license.crt</string>

常见集成问题

您的代码或引用的第三方代码，在集成时报与AlivcFFmpeg或AlivcConan的symbol有冲突

更多关于播放器使用过程中出现的问题及解决方案，请参见iOS端。

功能使用文档

• 基础功能

• 进阶功能