IOS版本 - 伯索开放平台

📌

iOS版本1.53.310

一. 准备阶段
PlasoStyleUpime 支持多种集成方式，推荐使用Cocoapods 集成：

开始前确保你已安装 Cocoapods。参考 Getting Started with CocoaPods 安装说明

在 Terminal 里进入项目根目录，并运行 pod init 命令。项目文件夹下会生成一个 Podfile 文本文件

打开 Podfile 文件，修改文件为如下内容。注意将 Your App 替换为你的 Target 名称，并将 version 替换为你需集成的 SDK 版本，当前最新版本为 1.53.302

 target 'Your App' do
    pod 'PlasoStyleUpime', '~> 1.53.310'
    pod 'PlasoUpimeSdkModule', '~> 1.53.310'
 end

在 Terminal 内运行 pod install 命令安装 PlasoPureUpime_iOS SDK。成功安装后，Terminal 中会显示 Pod installation complete!，此时项目文件夹下会生成一个 xcworkspace 文件。

打开新生成的 xcworkspace 文件, 配置 info.plist：

Privacy - Bluetooth Always Usage Description                    "Your comment"
Privacy - Bluetooth Peripheral Usage Description                "Your comment"
Privacy - Microphone Usage Description                          "Your comment"
Privacy - Photo Library Additions Usage Description             "Your comment"
Privacy - Camera Usage Description                              "Your comment"
Privacy - Photo Library Usage Description                       "Your comment"
Privacy - Local Network Usage Description                       "Your comment"
io.flutter.embedded_views_preview

6.info.plist中添加以下配置，关闭Flutter Impeller渲染器

  <key>FLTEnableImpeller</key>
  <false />

二. 创建课堂

创建课堂相关参数

参数名	参数类型	是否必须	默认值	参数说明
openFilenMode	int	否	1	文件显示模式：1.图片模式 2.窗口模式
supportCloudBox	boolean	否	true	支持打开云端文件
supportLocalFile	boolean	否	true	支持打开本地文件
enableVideoMark	boolean	否	true	视频暂停标注
enableSEndMessage	boolean	否	true	允许发送消息
configKey	string	否	""	"white", "purplegreen", "black", "red", "orange", "yellow","green", "lightblue", "skyblue", "blue", "purple", "pink"
teachToolTypes	boolean	否	true	新教具:三角、矩形、椭圆、实线、虚线、正方形、圆形
enableInteractPPT	boolean	否	true	可交互PPT
useNewSmallboard	boolean	否	true	新小黑板
toolBoxTypes	NS_ENUM	否	0	提供随堂测、定时器、小黑板、红包雨、浏览器、抢答器、骰子
waterMark	string	否	""	水印
waterMarkSize	double	否	0	水印文字大小
waterMarkOpacity	double	否	0	水印文字透明度 (0-1.0)
waterMarkDynamic	boolean	否	false	水印是否动态
supportUndo	boolean	否	true	支持撤销
redPacketLimit	int	否	0	红包雨上限
endRemindTime	long	否	0	终止时间
defaultPermission	int	否	-	会议默认权限(0/1/2/4组合)
supportSelect	boolean	否	true	支持工具栏选择
supportHighlighter	boolean	否	false	是否支持荧光笔
shouldForbiddenScreenShot	boolean	否	false	是否防截屏
enableNewClassExam	int	否	0	新版随堂测选择题：1；新版随堂测填空题：2；新版随堂测选择+填空：3
d_enableObjectEraser	int	否	0	点擦: 0，对象擦：1（手写），3（手写+文本框），5（手写+图形），7（手写+文本框+图形）
enableSaveBoard	boolean	否	false	是否支持保存白板
如何生成Query

private func generateQuery() -> String {
  let beginTime = Int(Date().timeIntervalSince1970)
  var parameters: [String : Any] = [:]
  parameters["beginTime"] = beginTime
  parameters["groupUserCount"] = 3
  parameters["validTime"] = 10800
  if featureConfigVC.doubleTeacherEnabled() {
      parameters["videoStream"] = 18
  }

  for vc in viewControllers {
      let dic = vc.configInfoParameter()
      parameters.appendDic(dic)
  }

  print(parameters)
  var query  = Tool.sign(params: parameters)

  let customAddress = rtcConfigVC.customAddress()
  if customAddress.count > 0 {
      if (customAddress.firstIndex(of: "?") != nil)   {
          query = customAddress + "&" + query
      } else {
          query = customAddress + "?" + query
      }
   }

   return query
}

query相关参数

参数名	参数类型	是否必须	默认值	参数说明
appId	string	是	string	-
appType	string	否	liveclassSDK	-
groupUserCount	int	否	3	用户人数
loginName	string	是	""	用户名
mediaType	int	否	1	媒体类型: 1.视频课 2.音频课
meetingType	int	是	public	课堂类型：public
meetingId	string	是	1	课堂id
userName	string	否	""	用户名字
userType	int	是	0	"speaker", "listener", "assistant", "visitor", "superlistener", "weblistener"
vaildTime	int	是	6	在线人数:1vN
d_sharpness	int	否	0	清晰度：标清(10) 高清(20) 超清(30)
d_dimension	string	否	1280 * 720	屏幕比例
beginTime	int	是	-	课堂开始时间
endTime	int	否	-	课堂结束时间
endRemindTime	int	否	-	课堂结束时间弹窗提醒
enableNewClassExam	int	否	0	老版随堂测：0；新版随堂测选择题：1；新版随堂测填空题：2；新版随堂测选择+填空：3
d_enableObjectEraser	int	否	0	点擦: 0，对象擦：1（手写），3（手写+文本框），5（手写+图形），7（手写+文本框+图形）
enableSaveBoard	boolean	否	false	是否支持保存白板

三. 插入外部文件

NSString *query = @"appId=1866&appType=liveclassSDK&beginTime=1603875514&cloudDisk=true&groupUserCount=3&live=1&mediaType=audio&meetingId=test111111&meetingType=public&userName=hello&userType=speaker&validTime=10800&signature=FF501B62C7D372B2927835F016A980FE6115D692";
UIViewController <UpimeLiveProtocol> *liveVC = [PlasoStyleUpimeClient createLiveWithQuery:query];

UpimeFile *file = [[UpimeFile alloc] init];
file.type = UpimeFileType_PPT;
file.title = @"演示文稿";
file.url = filePath;    // 文件路径
[liveVC insertFile:file];

四. 参考代码Demo

使用步骤（若模拟器无法运行，建议使用真机运行）

解压缩

打开 Podfile 文件，修改文件为如下内容。注意将 Your App 替换为你的 Target 名称，并将 version 替换为你需集成的 SDK 版本，当前最新版本为 1.53.302

target 'Your App' do
    pod 'PlasoStyleUpime', '~> 1.53.310'
    pod 'PlasoUpimeSdkModule', '~> 1.53.310'
end

修改文件：PlasoSdkDemoForiOS/PlsoSdkDemoForiOS/AppConfig，填入伯索分配的appid和key后即可体验。

static var appId: String = ""
static var appKey: String = ""