使用 iOS SDK - 移动开发平台 mPaaS

初始化 ARTVCEngine 并监听事件回调

初始化设置 uid 和 delegate。

     
      _artvcEgnine = [[ARTVCEngine alloc] init];
      _artvcEgnine.uid = self.uid;
      _artvcEgnine.delegate = self;

监听事件回调（按需实现回调，比如错误处理是需要实现的）。

     
      #pragma mark - ARTVCEngineDelegate
      -(void)didReceiveRoomInfo:(ARTVCRoomInfomation*)roomInfo{
      }
      -(void)didReceiveLocalFeed:(ARTVCFeed*)localFeed{
        self.feedForPreview = localFeed;
      }
      -(void)didEncounterError:(NSError *)error forFeed:(ARTVCFeed*)feed{
        [self showToastWith:[NSString stringWithFormat:@"%@, Error:%@",feed,error] duration:2.0];
      }
      .....

设置视频编码分辨率

设置视频编码分辨率代码如下：

   
    //设置视频编码分辨率，默认是 ARTVCVideoProfileType_640x360_15Fps。
    artvcEgnine.videoProfileType = ARTVCVideoProfileType_640x360_15Fps;

设置自动/手动推拉流开关

设置自动/手动推拉流开关代码如下，默认为自动推流/拉流。

   
    _artvcEgnine.autoPublish = YES;
    _artvcEgnine.autoSubScribe = YES;

设置是音视频通话还是纯音频通话

音视频通话

     
      ARTVCPublishConfig* config = [[ARTVCPublishConfig alloc] init];
      config.videoEnable = YES;//默认是 YES
      config.audioEnable = YES;//默认是 YES
      config.videoProfile = _artvcEgnine.videoProfileType;
      _artvcEgnine.autoPublishConfig = config;
      ARTVCSubscribeOptions* options = [[ARTVCSubscribeOptions alloc] init];
      _artvcEgnine.autoSubscribeOptions = options;

纯音频通话

     
      ARTVCPublishConfig* config = [[ARTVCPublishConfig alloc] init];
      config.videoEnable = NO;
      config.audioEnable = YES;//默认是 YES
      _artvcEgnine.autoPublishConfig = config;
      ARTVCSubscribeOptions* options = [[ARTVCSubscribeOptions alloc] init];
      options.receiveVideo = NO;
      _artvcEgnine.autoSubscribeOptions = options;

音视频通话下启动相机预览

对于纯音频通话，跳过此步骤。

   
    //默认使用前置摄像头，如果设置为 YES 则使用后置摄像头。
    [_artvcEgnine startCameraPreviewUsingBackCamera:NO];

启动相机预览后，如果本地 feed 没有被回调过。之后回调会返回一个 ARTVCFeed 对象，可用于关联后续返回的渲染 view。

     
      -(void)didReceiveLocalFeed:(ARTVCFeed*)localFeed forPublishConfig:(ARTVCPublishConfig*)publishConfig{
      self.feedForPreview = localFeed;
      }

预览 view 初始化的回调。

     
      -(void)didVideoRenderViewInitialized:(UIView*)renderView forFeed:(ARTVCFeed*)feed{
      if([feed isEqual:self.feedForPreview]){
      [self showToastWith:@"video preview view created" duration:1.0];
      }else{
      self.feedForRemote = feed;
      };
      //可触发 UI 布局，把 renderView add 到 view 层级中去
      }

预览首帧渲染的回调。

     
      -(void)didFirstVideoFrameRendered:(UIView*)renderView forFeed:(ARTVCFeed*)feed{
      }

创建或者加入房间

作为主叫方，创建房间。

     
      ARTVCCreateRoomParams* params = [[ARTVCCreateRoomParams alloc] init];
       params.uid = self.uid;
       params.bizName = DEMO_BIZ;
       params.subBiz = DEMO_SUBBIZ;
       params.signature = DEMO_SIGNATURE;
       [_artvcEgnine createRoom:params];

创建房间成功，会有房间信息回调。

       
        -(void)didReceiveRoomInfo:(ARTVCRoomInfomation*)roomInfo{
        }

创建房间失败，会有 Error 回调。

       
        //error.code == ARTVCErrorCodeProtocolErrorCreateRoomFailed
        -(void)didEncounterError:(NSError *)error forFeed:(ARTVCFeed*)feed{
        }

其他人加入房间后，会有成员加入房间的回调。

       
        -(void)didParticepantsEntered:(NSArray<ARTVCParticipantInfo*>*)participants{
        }

作为主被叫方，加入房间。

     
      ARTVCJoinRoomParams* params = [[ARTVCJoinRoomParams alloc] init];
       params.uid = self.uid;
       params.bizName = DEMO_BIZ;
       params.subBiz = DEMO_SUBBIZ;
       params.roomId = self.roomId;
       params.signature = DEMO_SIGNATURE;
       params.rtoken = self.rtoken;
       [_artvcEgnine joinRoom:params];

加入房间成功，会有加入房间成功的回调以及房间已有成员的回调。

       
        -(void)didJoinroomSuccess{
        }
        -(void)didParticepantsEntered:(NSArray<ARTVCParticipantInfo*>*)participants{
        }

加入房间失败，会有 error 回调。

       
        //error.code == ARTVCErrorCodeProtocolErrorJoinRoomFailed
        -(void)didEncounterError:(NSError *)error forFeed:(ARTVCFeed*)feed{
        }

后续其他人加入房间后，会有成员加入房间的回调。

       
        -(void)didParticepantsEntered:(NSArray<ARTVCParticipantInfo*>*)participants{
        }

创建或者加入房间成功后开始推流与拉流

默认是自动推流与拉流。

推流/拉流过程中，有如下相关状态回调。

     
      -(void)didConnectionStatusChangedTo:(ARTVCConnectionStatus)status forFeed:(ARTVCFeed*)feed{
        [self showToastWith:[NSString stringWithFormat:@"connection status:%d\nfeed:%@",status,feed] duration:1.0];
        if((status == ARTVCConnectionStatusClosed)  && [feed.uid isEqualToString:[self uid]]){
            [self.artvcEgnine stopCameraPreview];//音视频通话下，停止摄像头。
            [self.artvcEgnine leaveRoom];
        }
      }

ARTVCConnectionStatus 状态解释。

枚举	值	解释
ARTVCConnectionStatusConnecting	200	开始发布和订阅时，首先回调该状态。
ARTVCConnectionStatusConnected	202	发布/订阅成功时回调该状态。
ARTVCConnectionStatusDisConnected	203	出现闪断，底层媒体流断开，底层会做自动重连。业务拿到这个回调仅做用户提示，不需要做 leaveRoom 处理。
ARTVCConnectionStatusFailed	204	底层 ICE 失败无法继续，是一个终极错误。业务拿到这个回调可做停止摄像头 leaveRoom 处理。
ARTVCConnectionStatusClosed	206	每个发布和订阅结束时，回调该状态。它是最后的状态，业务拿到这个回调可做停止摄像头 leaveRoom 处理。

推流成功后，其他房间成员会收到新 feed 的回调。

     
      -(void)didNewFeedAdded:(ARTVCFeed*)feed{
        [self showToastWith:[NSString stringWithFormat:@"new feed published by others:%@",feed] duration:2.0];
      }

自动订阅模式下，会主动订阅该 feed。

订阅成功后，房间其他成员会收到如下回调。

     
      -(void)didSubscriber:(NSString*)subscriber subscribedAFeed:(ARTVCFeed*)feed{
        [self showToastWith:[NSString stringWithFormat:@"subscriber subscribed :%@",feed] duration:2.0];
      }

通话结束

音视频通话停止摄像头并离开房间。

     
      [_artvcEgnine stopCameraPreview];
      [_artvcEgnine leaveRoom];

纯音频通话离开房间。

     
      [_artvcEgnine leaveRoom];

成员离开房间后，房间其他成员会收到成员离开的回调。

     
      -(void)didParticepant:(ARTVCParticipantInfo*)participant leaveRoomWithReason:(ARTVCParticipantLeaveRoomReasonType)reason{
        [self showToastWith:[NSString stringWithFormat:@"participant left:%@ reason:%d",participant,reason] duration:2.0];
      }

自动发布订阅模式下离开房间，会自动取消发布本地的流以及取消订阅曾订阅过的流。

取消发布后，房间其他成员会收到取消发布的回调。

     
      -(void)didFeedRemoved:(ARTVCFeed*)feed{
        [self showToastWith:[NSString stringWithFormat:@"feed unpublished by others:%@",feed] duration:2.0];
      }

取消订阅后，房间其他成员会收到取消订阅的回调。

     
      -(void)didSubscriber:(NSString*)subscriber unsubscribedAFeed:(ARTVCFeed*)feed{
        [self showToastWith:[NSString stringWithFormat:@"subscriber unsubscribed :%@",feed] duration:2.0];
      }