智汇云-智联视界，汇创未来

# ios推流SDK开发文档

### iOS推流SDK简单介绍：

360直播云以SDK形式提供推流器，可以帮助开发者快速实现推流能力。SDK包括开发文档、开发demo、framework库文件。开发者可参考文档或demo，framework文件加入APP的工程中，完成相关配置，调用相关的API即可实现推流功能。

系统属性

| 系统特性 | 支持内容     |
| -------- | ------------ |
| 系统版本 | iOS8+        |
| 流媒体协议 | RTMP、私有协议  |
| 硬件特性 | armv7、arm64 |

推流属性

| 推流功能 | 支持内容     |
| -------- | ------------ |
| 基础功能 | 推流、断流续推 |
| 拓展功能 | 发送用户自定义数据、调整分辨率 |

### SDK集成方法介绍：

#### 初始化
需要调用`[QHVCCommonCoreEntry coreOnAppStart:appId
                                 appVer:version
                               deviceId:deviceId
                                  model:model
                         optionalParams:nil];`，接口说明如下：

appId(也叫businessId)是为业务分配的业务ID（appId获取地址：登录[视频云官网](https://zyun.360.cn/)-控制台-SDK-应用管理-新建应用）【见下图】；version为业务端APP的版本号；deviceId为设备唯一标识；uid为业务方用户标识，只要保证唯一即可;options可选，通常传nil，如有特殊需求详见参数说明。

![创建AppId截图](http://p5.qhimg.com/t011da35ea7b6063845.png)

[点此查看应用ID](https://zyun.360.cn/console/sdk/application)

> 对appId和channelID这两个参数的引入，在设计之初目的是为了每个业务有独立的ID，通过appId来获取云端的一些参数控制，特别是视频缓冲策略、P2P行为、硬解码黑白名单以及解码库类型；channelID更多的为数据统计打点的唯一标注，可以通过云点播和云直播的服务标识来获取，以此获取播放数据反馈。UserID的设计是为了业务方和视频云唯一的沟通桥梁，只要保持唯一即可，一般为用户ID的加密字符串，通过UserID可以排查到一个用户的级别的失败日志；

#### APPID合法性验证

需要调用 `[QHVCCommonCoreEntry validityCheck:token randNum:randNum authTime:authTime callback:^(QHVCAuthStatus ret, NSString *detail) {
    }];，接口说明如下：

合法性验证需要用到appId, Access Key(简称AK)和Secret Key(简称SK)。AK、SK获取地址： 登录[视频云官网](https://zyun.360.cn/)-用户中心-秘钥管理【见下图】。
只有appId、Access Key以及Secret Key相匹配，才能通过鉴权，否则将无法正常使用SDK。

![秘钥获取](http://p2.qhimg.com/t0146c3d44e71ae7a62.png)

[点此查看秘钥](https://zyun.360.cn/console/usercenter/accesskey)

==注意：此接口必须在启动APP后120秒内调用，否则将无法正常使用SDK。==

appId使用和SDK初始化时同样的内容，callback可以用来监听合法性验证结果。 计算authorization时需要使用AK、SK以及当前系统的时间戳和随机数。
**为了保证AK、SK的安全，请业务接入时，务必把AK和SK存储在服务端，并且把authorization的计算也放在服务端来做。**

计算authorization的示例代码如下：

```
    NSString *randNum = [NSString stringWithFormat:@"%u", arc4random() + 1];
    NSString *authTime = [NSString stringWithFormat:@"%lld", [QHVCToolUtils getCurrentDateByMilliscond]/1000];
    QHVCGlobalConfig* globalConfig = [QHVCGlobalConfig sharedInstance];//参数配置
    NSString *AK = globalConfig.appKey;
    NSString *SK = globalConfig.appSecret;
    NSString *paramsStr = [NSString stringWithFormat:@"appid=%@", [QHVCGlobalConfig sharedInstance].appId];
    NSString *paramsSign = [QHVCToolUtils getMD5String:[NSString stringWithFormat:@"%@%@", [QHVCToolUtils getMD5String:paramsStr], randNum]];
    NSString *authString = [NSString stringWithFormat:@"%@\n%@\n%@\n%@", AK, authTime, randNum, paramsSign];
    NSString *sign = [QHVCToolUtils hmacSha1:SK data:authString];
    NSString *token = [NSString stringWithFormat:@"%@:%@", AK, sign];
```

鉴权状态码：

```
typedef NS_ENUM(NSInteger, QHVCAuthStatus)
{
    QHVCAuthStatus_OK = 1,                //鉴权成功
    QHVCAuthStatus_FAILED = -11001,       //鉴权失败
    QHVCAuthStatus_NOT_INVOKED = -11002   //未调用鉴权接口
};
```

####下载工程，demo对接

通过360直播云平台创建应用，然后获取到SDK使用的appid，然后下载iOS推流SDK

####函数及配置说明
#####添加依赖库
TARGETS->General->Embed Binaries

QHVCLiveKit.framework

QHVCCommonKit.framework

##### 引入头文件
```
#import <QHVCLive/QHVCLive.h>
```
##### 如果需要走调度调用如下接口
```
[QHVCCommonScheduleEntry doScheduling:@"唯一sessionid" params:&sp]
```
##### 开流
```
publish_settings_t settings;
settings.baseSettings.sid = “唯一id”;
settings.baseSettings.event_cb = callback_t;
settings.baseSettings.event_context = (__bridge void *)self;
settings.baseSettings.retry_max = 9;
settings.rtmpPushAddr = NULL;
if (addr)
{
//走调度的时候不用设置地址
settings.rtmpPushAddr = [addr UTF8String];
}
settings.needMp4Optimize = NO;

settings.mp4FileName = NULL;
settings.isOnlyToFile = false;

//根据编码参数设置
media_settings_t media_setting;

- (BOOL)openStream:(struct publish_settings *)publishSettings media_settings:(struct media_settings *)mediaSettings
```
##### 推视频
```
- (void)videoEncodedFrame:(CMSampleBufferRef)sampleBuffer;
```
##### 推音频
```
- (void)audioEncodedFrame:(NSMutableData *)audioFrame pts:(CMTime)pts;
```
##### 停止
```
- (int)publish_free_sessionWithReason:(int)reason isSwitch:(BOOL)isSwitch;
```

存储服务

网络加速

企业应用

视频应用

视频工具

内容安全

OCR识别

人脸与人体识别

图像技术

AI开发平台

AI市场

物联网视频

物联网平台

区块链通用服务

开测平台

运营

视频

物联网

数据上云

IoT设备

账号体系

私有化部署

智慧城市

电商

教育

全屋智能

医疗

智能制造

游戏

SDK管理

电话咨询：

联系我们

热门产品

帮助文档

服务条款

请您联系我们

小安提醒您

给我们留言