# 硅基直播IOS SDK1.0使⽤⽂档

新建⽇期： 2023-7-24 修改⽇期： 2023-7-24

IOS系统最低版本：IOS12

# ⼀. 物料准备

  1. 下载Demo包 live_demo_ios.zip (opens new window)
  2. 内含 DigitalLiveSDK.framework、WebRTC.framework

# ⼆. 开发环境

开发⼯具: Xcode

# 三. sdk引⽤（参照DigitalLiveDemo）

  1. 将 DigitalLiveSDK.framework和webrtc⽂件拖拽至工程的资源目录下并设置为Embed&Sign:
  2. Info.plist文件中添加相机权限和录音权限

# 模块使⽤ 代码样例

详细⻅GJDigitalSDKDemo⽬,关键代码样例:

    //获取的token
    [DigitalLiveConfig shareConfig].token=[ConfigManager manager].token;//从后端接口获取的token
    [DigitalLiveConfig shareConfig].sessionId= sessionId;//会话ID //从后端接口获取
    [DigitalLiveConfig shareConfig].userName=[ConfigManager manager].mqttUser;//MQTT连接用户名 //从后端接口获取
    [DigitalLiveConfig shareConfig].userPassword=[ConfigManager manager].mqttPassword;//MQTT连接密钥 //从后端接口获取
    [DigitalLiveConfig shareConfig].serverIP=MQTTURL;//MQTT连接地址 
    [DigitalLiveConfig shareConfig].auidoType=self.audioType;//0 录音模式 1 音频文件发送buffer
    NSLog(@"self.audioType:%ld",self.audioType);
    [DigitalLiveConfig shareConfig].topicPub=topicPub;//客户端发送topic //从后端接口获取
    [DigitalLiveConfig shareConfig].topicSub=topicSub;////客户端接收topic //从后端接口获取
    [DigitalLiveConfig shareConfig].sequence=self.scence_model.videoCoverUrl;;//数字人场景视频地址
    [DigitalLiveConfig shareConfig].udCode= self.scence_model.sceneCode;//数字人场景code
    [DigitalLiveConfig shareConfig].greenType=1;//绿幕背景
    [DigitalLiveConfig shareConfig].liveId=self.listModel.Id;//直播间ID
    [DigitalLiveManager manager].remote_view=self.remotView;//远程视频
    [DigitalLiveManager manager].delegate=self;//代理
    [[DigitalLiveManager manager] toStart];//开始MQTT通讯

# SDK关键接口

/*
* 开始初始化通讯并且是否开启本地摄像头
*/
-(void)toStart;
/*
* 结束通讯
*/
-(void)toStop;
/*
*打开本地摄像头
*/
- (void)toOpenCamera;
/*
*关闭本地摄像头
*/
-(void)toStopCamera;
/*
*ES静音 NO非静音
*/
-(void)setMute:(BOOL)isEnabled;
/*
*开始推流
*/
-(void)toStartPushtoproxy;

/*
*发送本地音频或网络音频的buffer给webrtc
*/
-(void)deliverRecordedData:(CMSampleBufferRef)sampleBuffer;

# SDK代理

@protocol DigitalLiveDelegate <NSObject>
@optional
/*
*错误信息返回码
*/
- (void)onError:(NSInteger)error_code;
/*
*远程视频通讯完成
*/
- (void)onRTCReomteSuccess;
/*
*中控获取不到渲染端信息后通知客户端繁忙
*/
- (void)onBusy;
/*
*中控结束通话，发送bye事件
*/
- (void)onByeBye;
/*
*是否成功加载数字人
*/
- (void)onVideoShow:(BOOL)isSuccess :(float)progress;
/*
*获取本地视频的视频流
*/
- (void)capturer:(RTCVideoCapturer *)capturer didCaptureVideoFrame:(RTCVideoFrame *)frame;
/*
*中控返回的所有json字典
*/
-(void)onMessageDic:(NSDictionary*)messageDic;
@end

# 四. 相关协议

# 人工智能生成合成内容标识规范

（1）我们将依据相关法律法规，对人工智能生成合成内容添加相应标识（如在生成合成内容或者交互场景界面中添加的显式标识，采用技术措施在生成合成内容的文件元数据中添加的隐式标识）。您应确保您已仔细阅读并理解《人工智能生成合成内容标识办法》及其他相关的标识管理要求。您不得使用或尝试使用任何技术手段或其他方法删除、篡改、伪造、隐匿该等生成合成内容标识，不得为他人实施删除、篡改、伪造、隐匿该等生成合成内容标识行为提供工具或者服务，不得通过不正当标识手段损害他人合法权益。
（2）在特定场景下，为更好地满足您的使用需求，我们可能根据您的申请为您提供没有添加显式标识的人工智能生成合成内容。如您申请我们提供没有添加显式标识的生成合成内容的，您需承诺并保证：
①不利用该内容发布、传播任何虚假信息或从事其他任何违法违规活动；
②在发布或传播基于深度学习、虚拟现实、深度合成、生成式人工智能等新技术制作的非真实信息，或其他可能引发公众误解或混淆的信息内容时，应当以显著方式标识；
③在向第三方分享该内容或使用网络信息内容传播服务发布该内容或以其他方式使用该内容时，主动声明其为人工智能生成合成内容；
④遵守其他相关法律、法规、政策、办法的规定。
（3）如您违反上述约定，您应自行承担由此引起的所有责任，并赔偿由此给我们及第三方造成的全部损失（包括但不限于直接损失、间接损失、诉讼费、仲裁费、公证费、鉴定费、律师费、差旅费、保全费用、保全保险费、向任何第三方承担的责任、行政处罚、罚款等）。