安装iOS SDK
环境准备
- 运行环境
- iOS9.0及以上系统
- Xcode9.0+
- 前置条件
iOS App需要集成以下SDK
- 播放器SDK
- 低延时播放器SDK
- 百度Pass SDK(可选)
- 百度地图SDK(可选)
下载和安装
- 下载iOS App压缩包 evsapp.zip ,iOS App 安装包 evsapp.ipa.zip
- 将下载的压缩包解压后,将lib文件夹复制到自己的工程文件夹中
- 点击左侧目录选中工程名,在Build Phases-> Link Binary With Libaries中点击“+”按钮,在弹出的窗口中点击“Add Other”按钮,选择上一步拷贝的库
- 添加SDK所依赖的系统库
框架名称 | 说明 |
---|---|
BDCloudAVMediaPlayer.framework | 播放器SDK(动态库) |
BaiduRtcPlayer.framework | 低延时播放器 |
PassFoundationKit.framework | PassSDK基础库 |
PassportKit.framework | PassSDK账户相关库 |
BaiduMapAPI_Base.framework | 百度地图基础库 |
BaiduMapAPI_Search.framework | 百度地图检索库 |
libcrypto.a | 静态依赖库 |
libssl.a | 静态依赖库 |
libsrt.a | 静态依赖库 |
libffmpeg.a | 静态依赖库 |
libyuv.a | 静态依赖库 |
libSSDKLib.a | 接入Pass SDK需要的依赖 |
libnetwork.tbd | 系统框架 |
VideoToolbox.framework | 系统框架 |
GLKit.framework | 系统框架 |
SystemConfiguration.framework | 系统框架 |
CoreTelephony.framework | 系统框架 |
CoreLocation.framework | 系统框架 |
WebKit.framework | 系统框架 |
libc++.tbd | 系统框架 |
libz.tbd | 系统框架 |
libsqlite3.0.tbd | 系统框架 |
SDK目录结构
evsapp
├── Utils //工具类
├── Page //App
│ └── Common //基础
│ └── Home //首页模块
│ └── Player //播放器模块
│ └── Manage //管理模块
│ └── Profile //个人中心模块
│ └── Login //登录模块
├── Resource //资源(license文件位置)
├── AppDelegate.h
├── AppDelegate.m
├── PrefixHeader //pch文件
├── Assets //图片资源
└── PassportKit //Pass所需资源(可选)
以下为App使用的各SDK详细接入流程
播放器SDK接入
1.下载播放器SDK
SDK官网下载地址:播放器下载地址
2.拷贝lib 文件夹到工程中,将BDCloudAVMediaPlayer.framework添加到工程中,App中的BDCloudAVMediaPlayer.framework库为动态库,需要将其设置为Embed&Sign
3.申请播放器SDK license,将申请的license文件下载添加到Resource文件下
4.在AppDelegate.m文件中进行初始化,调用SDK的认证方法配置license ID,授权成功才可播放视频。
低延时播放器接入
1.将lib文件夹中的BaiduRtcPlayer.framework添加到工程中
2.将lib文件夹中的libsrt.a、libssl.a、libffmpeg.a、libyuv.a、libcrypto.a添加到工程中
3.工程中需要设置流媒体URL和信令服务器URL:
1)设置流媒体URL,对应格式为webrtc://xxxx,通过网络请求获取播流地址
GET /v1/evs_app/device/{channelId}/signedUrl?protocol={protocol}
@param channelId 是 国标设备通道ID
@param protocol 是 协议类型,默认rtmp,可选rtmp/flv/hls/webrtc
@return @{@"url":@"播放地址webrtc://xxxx"}
2)设置流媒体信令服务器URL,对应格式为https://xxxxxxx
static NSString * const KSignalServer = @"https://rtc2.exp.bcelive.com:8989/brtc/v3/pullstream"; //默认使用
详细请参考BDDevicePreviewViewController.m文件。
百度Pass SDK接入
提供的App登录账户系统使用的是Pass SDK,此SDK按需求添加使用。
接入百度Pass SDK请参考Pass SDK接入文档:Pass接入文档
Pass SDK配置步骤
1.在AppDelegate.m文件中进行Pass SDK初始化,填写对应的TPL,AppKey,AppId等
2.点击左侧目录选中工程名,Signing&Capabilities -> +Capability -> KeyChain Sharing 填入Keychain Groups如图所示
百度地图SDK接入
提供的App使用到百度地图地点检索功能,此SDK按需求添加使用。
1.进入百度地图官网百度地图,控制台 -> 我的应用 -> 创建应用,填写对应的Bundle ID及其信息,获取相应的AK
2.在AppDelegate.m文件中进行初始化,调用SDK的认证方法配置AK