urtc-mac-demo

urtc mac 端demo

1 描述

UCloudRtcSdk_mac.framework 是UCloud推出的一款适用于MacOS平台的实时音视频 SDK提供了音视频通话基础功能，提供灵活的接口，支持高度定制以及二次开发。

2 功能列表

2.1 基本功能

基本的音视频通话功能
支持内置音视频采集的常见功能
支持静音关闭视频功能
支持视频尺寸的配置(180P - 720P)
支持自动重连
支持丰富的消息回调
支持纯音频互动
支持视频的大小窗口切换
支持获取视频房间统计信息（帧率、码率、丢包率等）
支持编码镜像功能
支持屏幕录制功能
支持自动手动订阅自动手动发布
支持权限（上行/下行/全部）控制
支持音量提示
支持获取sdk版本

2.2 增值功能

终端智能测试（摄像头、麦克风、网络、播放器）
视频录制/视频存储
视频水印
视频直播CDN分发
美颜
贴纸/滤镜/哈哈镜
背景分割
手势
虚拟形象
变声

3 方案介绍

3.1 方案架构

3.2 方案优势

利用边缘节点就近接入
可用性99.99%
智能链路调度
自有骨干专线+Internet传输优化
数据报文AES加密传输
全API开放调度能力
端到端链路质量探测
多点接入线路容灾
抗丢包视频30% 音频70%
国内平均延时低于75ms 国际平均延时低于200ms

4 应用场景

4.1 主播连麦

支持主播之间连麦一起直播，带来与传统单向直播不一样的体验 48KHz 采样率、全频带编解码以及对音乐场景的特殊优化保证观众可以听到最优质的声音

4.2 视频会议

小范围实时音视频互动，提供多种视频通话布局模板，更提供自定义布局方式，保证会议发言者互相之间的实时性，提升普通观众的观看体验

4.3 泛文娱

4.3.1 一对一社交

客户可以利用UCloud实时音视频云实现 QQ、微信、陌陌等社交应用的一对一视频互动

4.3.2 狼人杀游戏

支持15人视频通话，玩家可在游戏中选择只开启语音或同时开启音视频

4.4 在线教育

支持自动和手动发布订阅视频流，方便实现课堂虚拟分组概念，同时支持根据角色设置流权限，保证课程秩序

4.5 在线客服

线上开展音视频对话，对客户的资信情况进行审核，方便金融科技企业实现用户在线签约、视频开户验证以及呼叫中心等功能提供云端存储空间及海量数据的处理能力，提供高可用的技术和高稳定的平台

5 快速使用

5.1 初始化

建议在初始化 App 的同时，初始化 SDK。

5.1.1 导入 SDK 头文件

<UCloudRtcSdk_mac/UCloudRtcSdk_mac.h>

5.1.2. 设置 userId 和 roomId，获取AppID；

5.1.3 初始化UCloudRtcEngine 并设置代理以接收相关回调信息；

UCloudRtcEngine *engine = [[UCloudRtcEngine alloc]initWithAppID:APP_ID appKey:APP_KEY completionBlock:^(int errorCode) {}];;
engine.delegate = self;

5.1.4 配置参数

初始化完成后，即可调用 SDK相关接口，实现对应功能。使用之前需要对SDK进行相关设置，如果不设置也可以，系统将会采用默认值。

self.engine.isAutoPublish = YES;//加入房间后将自动发布本地音视频 默认为YES
self.engine.isAutoSubscribe = YES;//加入房间后将自动订阅远端音视频 默认为YES
self.engine.isOnlyAudio = NO;//将启用纯音频模式 默认为NO
self.engine.isDebug = NO;//是否开启日志
self.engine.videoProfile = UCloudRtcEngine_VideoProfile_360P_1;//设置视频分辨率
self.engine.streamProfile = UCloudRtcEngine_StreamProfileAll;//设置流权限

5.2 加入房间

[self.engine joinRoomWithRoomId:self.roomId userId:self.userId token:toekn completionHandler:^(NSDictionary * _Nonnull response, int errorCode) {
  if ([[response valueForKey:@"isRejoin"] boolValue]) {
      NSLog(@"-----重连加入-----");
  } else {
      NSLog(@"-----首次加入房间-----");
  }
}];

5.3 发布本地流

自动发布模式下，joinRoom成功后，即可发布本地流，无需再次调用publish接口；
手动发布模式下，joinRoom成功后，可通过下述接口发布本地流；
```
  [self.engine publishWithMediaType:UCloudRtcStreamMediaTypeCamera];
```

发布过程中可以监听以下事件获取发布状态，根据状态调用渲染或其他接口即可。

  - (void)uCloudRtcEngine:(UCloudRtcEngine *)manager didChangePublishState:(UCloudRtcEnginePublishState)publishState {
      switch (publishState) {
                  case UCloudRtcEnginePublishStateUnPublish:
                      self.isConnected = NO;
                  break;
                  case UCloudRtcEnginePublishStatePublishing: {
                      [self.bottomButton setTitle:@"正在发布..." forState:UIControlStateNormal];
                  }
                  break;
                  case UCloudRtcEnginePublishStatePublishSucceed:{
                      self.isConnected = YES;
                      [self.view makeToast:@"发布成功" duration:1.5 position:CSToastPositionCenter];
                      [self.bottomButton setTitle:@"发布成功" forState:UIControlStateNormal];
                  }
                  break;
                  case UCloudRtcEnginePublishStateRepublishing: {
                      [self.bottomButton setTitle:@"正在重新发布..." forState:UIControlStateNormal];
                  }
                  break;
                  case UCloudRtcEnginePublishStatePublishFailed: {
                  self.isConnected = NO;
                      [self.bottomButton setTitle:@"开始发布" forState:UIControlStateNormal];
                  }
                  break;
                  case UCloudRtcEnginePublishStatePublishStoped: {
                  self.isConnected = NO;
                      [self.view makeToast:@"发布已停止" duration:1.5 position:CSToastPositionCenter];
                      [self.bottomButton setTitle:@"开始发布" forState:UIControlStateNormal];
                  }
                  break;
                  default:
                  break;
              }                               
          }

5.4 取消发布本地流

[self.engine unpublishWithMediaType:UCloudRtcStreamMediaTypeCamera];

5.5 订阅远程流

自动订阅模式下，joinRoom成功后，即可订阅远程流，无需再次调用subscribeMethod接口；\
手动订阅模式下，joinRoom成功后，可通过下述接口订阅远程流；\
```
  [self.engine subscribeMethod:remoteStream];
```

订阅成功，在回调事件中调用渲染接口即可。

  -(void)uCloudRtcEngine:(UCloudRtcEngine *)channel didSubscribe:(UCloudRtcStream *)stream{
      [self reloadVideos];
  }

5.6 取消订阅远程流

[self.engine unSubscribeMethod:remoteStream];

5.7 离开房间

[self.engine leaveRoom];

ucloud/urtc-mac-demo