智汇云-企业数智化核心引擎

# 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;
```

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

SDK管理

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费 咨询智汇云专属顾问

为您量身定制产品解决方案

1对1免费咨询智汇云专属顾问