集成 SDK
更新时间: 2024/08/07 10:23:29
本文介绍集成播放器 SDK 的方法。
开发环境要求
在开始运行示例项目之前,请确保开发环境满足以下要求:
环境要求 | 说明 |
---|---|
iOS 版本 | 9.0 及以上 |
CPU 架构 | ARM 64、ARM V7、x86_6(目前暂不支持 i386 架构) |
IDE | XCode |
其他 | 安装 CocoaPods。 |
目录结构
您需要将播放器 SDK 集成到应用中,包括静态库文件和相关的头文件。如下图所示。
播放器 SDK 提供两个 ZIP 包,分别是 NELivePlayer_Demo_Android_vx.x.x
和 LivePlayer_Android_SDK_vx.x.x
,两个 zip 包的用途和目录说明如下:
-
LivePlayer_iOS_Demo_vx.x.x
里面包含一个示例工程,为了方便开发时更加简单方便的使用播放器 SDK。Demo 中通过 NELivePlayerViewController 来调用相关接口来实现音视频播放。
-
LivePlayer_iOS_SDK_vx.x.x:
存放播放器 SDK 的静态库文件和头文件,包括真机版本和模拟器(x86_64)版本,文件说明如下表所示。
Framework 说明 是否必须 NMCBasicModuleFramework.framework 基础库 必须 NELivePlayerFramework.framework 播放器引擎 必须 NERtd.framework 低延时直播的播放器引擎 必须 NELPGslb.framework 直播点播调度引擎 必须 不同播放器版本的 Framework 库文件有差异,具体以实际的库文件为准。
集成SDK
步骤1 集成准备
- 创建ViewController,如下图所示。
- Subclass of 选择 UIViewController,如下图所示。
步骤2 快速集成
方法 1(推荐):通过 CocoaPods导入
-
安装 CocoaPods。
在终端窗口执行如下命令安装 CocoaPods。
sudo gem install cocoapods
-
创建
Podfile
文件。在终端窗口,通过
cd
命令进入项目根目录,执行如下命令,项目路径下会展示新创建的Podfile
文件。pod init
-
执行如下命令搜索资源。
pod search NELivePlayer
如果搜索不到,请执行如下命令清除搜索列表缓存。
rm ~/Library/Caches/CocoaPods/search_index.json
-
在
Podfile
文件中增加类似如下代码,添加依赖。pod 'NELivePlayer', '~> 3.1.2'
- 3.1.2 为播放器的版本号,请根据您的需要替换为对应的版本号。
- 访问网易云信 SDK 下载中心获取播放器最新的版本号。
-
执行如下命令安装 SDK。
pod install
如果无法安装播放器最新版本,请执行如下命令更新本地仓库。
pod repo update
方法 2 :手动导入库文件
-
下载最新版的播放器SDK,解压缩到本地。
-
将 SDK 中的 framework 导入到 App 工程。
- 在 Xcode 左侧的TARGETS 中选择目标项目,例如 NELivePlayerDemo,在顶部导航栏单击 Build Phrases 页签。
- 在 Link Binary with Libraries 区域,单击底下的 + 号图标,添加如下Frameworks:
- NMCBasicModuleFramework.framework
- NELivePlayerFramework.framework
- NERtd.framework
- NELPGslb.framework
不同播放器版本的 Framework 库文件有差异,具体以实际的库文件为准。
- 在顶部单击 General页签,在 Frameworks,Libraries,and Embedded Content 区域, 查看添加的Frameworks。并将 Embed 设置为 Embed & Sign。
-
添加播放器 SDK 到 App 工程。
在 Xcode 左侧的TARGETS 中选择目标项目,例如 NELivePlayerDemo, 在顶部导航栏单击 Build Settings 页签,在 Search Paths > Framework Search Paths 中选择播放器的 Frameworks 所在路径,具体如下图所示。
步骤3 在项目中导入 SDK
在项目需要使用 SDK API 的文件里,导入头文件。
#import <NELivePlayerFramework/NELivePlayerFramework.h>
常见问题
直接集成 Framework 的时候,如果打包遇到下图的问题,请按照以下方法处理:
-
将 Demo 中的
StripFrameworks.sh
脚本文件导入到工程中。 -
在 Build Phases 中增加 Run Script 过程,填入如下命令(XXX表示脚本所在的相对路径):
"${SRCROOT}/xxx/StripFrameworks.sh"