推拉流基础版组件集成说明1.概述1.1 功能特性1.1.1 基础版SDK功能1.1.2 白板插件功能1.1.3 聊天插件功能1.1.3 排麦插件功能1.2 阅读对象2.开发准备2.1 开发环境2.2 Xcode配置3.快速集成3.1 导入framework3.2 framework添加Embedded Binaries3.3 配置依赖库3.4 组件使用3.4.1 基础版SDK实例化3.4.2 文档组件实例化3.4.3 聊天组件实例化3.4.4 排麦组件实例化4 组件与基础版SDK建立关联5.API查询6.Q&A6.1 运行崩溃

推拉流基础版组件集成说明

1.概述

CC基础版SDK 是一个适用于iOS平台的云课堂SDK,使用此SDK可以与CC视频云服务进行对接,在iOS端使用CC视频的云课堂功能。

1.1 功能特性

ios端SDK目前支持了基础版SDK、白板插件、聊天插件以及排麦插件;

1.1.1 基础版SDK功能

功能特性描述备注
推流支持推流到服务器
拉流支持从服务器订阅流
获取流状态支持获取流的状态(发报数、收报数、丢包数、延时)
前后摄像头切换支持手机前后摄像头切换
后台播放支持直播退到后台只播放音频
支持https协议支持接口https请求

1.1.2 白板插件功能

用于展示老师端的操作;

1.1.3 聊天插件功能

功能特性描述备注
文本、表情发送支持接收服务端的文本和表情数据
图片发送支持接收服务器的图片数据
禁言分为指定用户的禁言,以及全体禁言

1.1.3 排麦插件功能

功能特性描述备注
自由连麦互动者可自由连麦,无需老师确认
自动连麦互动者进入房间后自动连麦
举手连麦互动者可举手申请连麦,需老师确认才可连麦

1.2 阅读对象

本文档为技术文档,需要阅读者:

2.开发准备

2.1 开发环境

2.2 Xcode配置

1. Build Settings   ->    Build Options  ->   Enable Bitcode   ->		NO
2. Build Settings -> Always Enbed Swift Standar Libraries ->YES
3. 工程加入动态库 CCClassRoomBasic.framework
4. 添加需要的系统库:VideoToolbox.framework、libstdc++.tbd、libicucore.tbd
5. General->Embedded Binaries中添加动态库 CCClassRoomBasic.framework
6. Build Settings   ->   Other Linker Flags 添加-ObjC
7. Capabilities -> Background Modes -> Audio,AirPlay,And Picture in Picture
8. Info.plist 增加Privacy - Microphone Usage Description、Privacy - Photo Library Usage Description、Privacy - Camera Usage Description、Privacy - Calendars Usage Description

3.快速集成

注:快速集成主要提供的是推流和拉流的功能(核心功能)。白板、聊天以及排麦组件另有开发文档描述。

首先,需要下载最新版本的SDK,下载地址为:Live_iOS_Play_SDK

3.1 导入framework

名称描述
CCClassRoomBasic.frameworkCC音视频核心jar包
CCDocLibrary.frameworkCC白板插件核心jar包
CCChatLibrary.frameworkCC聊天插件核心jar包
CCBarleyLibrary.frameworkCC排麦插件核心jar包

3.2 framework添加Embedded Binaries

由于framework是动态库需要将CCClassRoomBasic.framework、CCDocLibrary.framework 、CCChatLibrary.framework、CCBarleyLibrary.framework 添加到Embedded Binaries;

3.3 配置依赖库

工程需要下列系统库:libz.thd、libstdc++.thd、libicucore.thd、VideoToolBox.framework

3.4 组件使用

组件使用是基于基础版SDK的;

3.4.1 基础版SDK实例化

在需要使用SDK的文件引入头文件

 
import <CCClassRoomBasic/CCClassRoomBasic.h>
@interface 添加CCStreamerBasic、CCRoom实例属性,方便后续调用;
@property(nonatomic,strong)CCRoom   *room;
@property(nonatomic,strong)CCStreamerBasic *stremer;

创建SDK实例:

 
- (CCStreamerBasic *)stremer
{
    if (!_stremer) {
        _stremer = [CCStreamerBasic sharedStreamer];
    }
    return _stremer;
}
- (CCRoom *)room
{
    return [self.stremer getRoomInfo];
}

3.4.2 文档组件实例化

在需要使用文档组件的文件引入头文件

 
#import <CCDocLibrary/CCDocLibrary.h>
@interface CCDocVideoView 实例属性方便后续调用;
@property(nonatomic,strong)CCDocVideoView   *ccVideoView;

创建SDK实例:

 
- (CCDocVideoView *)ccVideoView
{
    if (!_ccVideoView) {
        CGRect frame = CGRectMake(0, 0, 200, 100);
        _ccVideoView = [[CCDocVideoView alloc]initWithFrame:frame];
        [_ccVideoView addObserverNotify];
    }
    return _ccVideoView;
}

3.4.3 聊天组件实例化

在需要使用文档组件的文件引入头文件

 
#import <CCChatLibrary/CCChatLibrary.h>
@interface CCChatManager实例属性方便后续调用;
@property(nonatomic,strong)CCChatManager    *ccChatManager;

创建SDK实例:

 
- (CCChatManager *)ccChatManager
{
    if (!_ccChatManager) {
        _ccChatManager = [CCChatManager sharedChat];
    }
    return _ccChatManager;
}

3.4.4 排麦组件实例化

在需要使用文档组件的文件引入头文件

 
#import <CCBarleyLibrary/CCBarleyLibrary.h>
@interface CCBarleyManager实例属性方便后续调用;
@property(nonatomic,strong)CCBarleyManager  *ccBarelyManager;

创建SDK实例:

 
- (CCBarleyManager *)ccBarelyManager
{
    if (!_ccBarelyManager) {
        _ccBarelyManager = [CCBarleyManager sharedBarley];
    }
    return _ccBarelyManager;
}

4 组件与基础版SDK建立关联

要使用文档、聊天、排麦组件需要配合基础版SDK使用,要建立关联,如下:

 
- (void)initBaseSDKComponent
{
    self.stremer = [CCStreamerBasic sharedStreamer];
    self.stremer.videoMode = CCVideoPortrait;
    [self.stremer addObserver:self];
    
    //白板
    [self.stremer addObserver:self.ccVideoView];
    [self.ccVideoView addBasicClient:self.stremer];
    //聊天
    [self.stremer addObserver:self.ccChatManager];
    [self.ccChatManager addBasicClient:self.stremer];
    //排麦
    self.stremer.isUsePaiMai = YES;
    [self.stremer addObserver:self.ccBarelyManager];
    [self.ccBarelyManager addBasicClient:self.stremer];
}

5.API查询

Doc目录打开index.html文件

6.Q&A

6.1 运行崩溃

 
dyld: Library not loaded: @rpath/CCClassRoomBasic.framework/CCClassRoomBasic
  Referenced from: /var/containers/Bundle/Application/E8CDE526-6F19-415B-9BA4-2380AB0A1FDE/CCClassRoom.app/CCClassRoom
  Reason: image not found

解决办法参考3.2