liuming / developer-docs

返回在线授课相关文档

页面内的动作消息的类型统一为templateAction，包括基本的动作类型，播放器的消息类型（带有子类型 subType:playerAction），回答的消息类型(subType:selectAnswer)，画板的消息类型(subType:drawPanelAction) type:templateAction

目前的subType类型

• basic (基本动作，拟追加)
• player (播放器)
• selectAnswer （选择问题）
• activity （课堂活动）

为了保证学生端和老师端的消息同步，页面内的动作消息包括消息索引(index)和页面索引(pageIndex)

通用的基本动作定义

• 单击控件(command:tap)
• 双击控件(command:doubleTap)
• 分段控件的点击(command:selectOptions)需要参数：点击的索引
• 分页ScrollView的滚动(command:gotoScrollPage)需要参数：目标页的索引

例子

{
type:templateAction
subType:basic
command:tap
controlId: WordExplanationImage1
index:2（保证页面内消息按顺序）
pageIndex:1
}

{
type:templateAction
subtype:basic
command:doubleTap
controlId:WordExplanationImage1
index:2（保证页面内消息按顺序）
pageIndex:1
}

{
type:templateAction
subtype:basic
command:selectOptions
controlId:WordCompareSegmentedControl
parameter:1(在这里是分段的索引)
index:2（保证页面内消息按顺序）
pageIndex:1
}

{
type:templateAction
subtype:basic
command:gotoScrollPage
controlId:LogicTreeScrellView
parameter:3(在这里是页码)
index:2（保证页面内消息按顺序）
pageIndex:1
}

多媒体播放器动作定义

• 播放(play)
• 暂停(pause)
• 停止(stop)
• 全屏(fullscreen)
• 小屏(smallscreen)
• 进度消息(progress)

{
  type:templateAction
  subType:player
  command:play
  index:2
  pageIndex:1
}

{
  type:templateAction
  subType:playerAction
  command:progress
  parameter:进度百分比
  index:2
  pageIndex:1
}

题目类动作定义（选择文字题，选择图片题）

• 选择题 包括测验题中的选择题，阅读理解，完形填空，音视频听力练习中的选择题，以及听音选图 在展示问题和选项的界面， 1.学生和老师都可以进行选择， 2.都可以进行多次选择，第二次选择时保留第一次选择的答案， 3.学生能操作的区域限制在选项区域 4.学生或者老师的选择会同步到对方的界面 5.对方做选择时，所选的选项在自己的界面可以晃一下作为提示

以下是指令信息示例

文字选择（包括测验题中的选择题，阅读理解，完形填空，音视频听力练习中的选择题）
{
  type:"templateAction"
  subType:"selectAnswer"
  command:"selectTextAnswer"
  parameter:"It is a book."
  index:2（保证页面内消息按顺序）
  pageIndex:1
}

听音选图
{
  type:"templateAction"
  subType:"selectAnswer"
  command:"selectImageAnswer"
  parameter:"图片id"
  index:2（保证页面内消息按顺序）
  pageIndex:1
}

下发课堂活动内容

目前暂时用在课堂活动拼写单词的内容下发中，为了让学生端和老师端拆分的单词保持一致

教师端拆分单词，然后发送下面的自定义消息 学生端在展现拆分的单词内容的时候，等待教师端发送的消息，然后按照教师端已经拆分好的结果进行展现

{
  type:"templateAction"
  subType:"activity"
  command:"splitWord"
  parameter:["wo","r","d"]
  index:2（保证页面内消息按顺序）
  pageIndex:1
}