按照课程ID获取投票列表
api名称:course.votes.list,SDK对应方法:courseVoteList
| 名称 |
类型 |
必选 |
描述 |
| course_id |
int |
Y |
课程ID |
| page |
int |
N |
页码,最大值为 10000 |
| size |
int |
N |
每页数量,最大值为 1000 |
| status |
string |
N |
获取投票的状态(all:全部;normal(默认):除了已删除的全部,voted:已发起的全部) |
| 名称 |
类型 |
描述 |
| vid |
int |
投票ID |
| pid |
int |
合作方ID |
| liveId |
int |
直播ID |
| course_id |
int |
课程ID |
| rid |
int |
房间ID |
| bid |
int |
欢拓系统的主播id |
| uid |
string |
发布者ID |
| nickname |
string |
发布者昵称 |
| type |
int |
类型 |
| status |
int |
状态 |
| title |
string |
投票主题 |
| options |
array |
投票选项 |
| opTotal |
int |
投票人数(没有该参数时,投票人数为0) |
| startTime |
int |
开始时间 |
| endTime |
int |
结束时间 |
按照投票ID和课程ID获取投票详情
api名称:course.votes.detail,SDK对应方法:courseVoteDetail
| 名称 |
类型 |
必选 |
描述 |
| vid |
int |
Y |
投票ID |
| course_id |
int |
Y |
课程ID |
| page |
int |
N |
页码 |
| size |
int |
N |
每页个数 |
| 名称 |
类型 |
描述 |
| vid |
int |
投票ID |
| uid |
string |
用户ID |
| nickname |
string |
用户昵称 |
| time |
int |
投票时间 |
| option |
string |
选项 |
| 名称 |
类型 |
描述 |
| vid |
int |
投票ID |
| pid |
int |
合作方ID |
| liveId |
int |
直播ID |
| course_id |
int |
课程ID |
| rid |
int |
房间ID |
| bid |
int |
欢拓系统的主播id |
| uid |
string |
发布者ID |
| nickname |
string |
发布者昵称 |
| type |
string |
类型 |
| status |
string |
状态 |
| title |
string |
投票主题 |
| options |
array |
投票选项 |
| opTotal |
int |
投票人数(没有该参数时,投票人数为0) |
| startTime |
int |
开始时间 |
| endTime |
int |
结束时间 |
| answer |
string |
正确答案 |
| stats |
array |
投票比例统计, op为选项,percent为百分比(50表示50%) |
发起投票
api名称:course.votes.add,SDK对应方法:courseVoteAdd
| 名称 |
类型 |
必选 |
描述 |
| course_id |
string |
Y |
课程ID |
| uid |
string |
Y |
投票发布者,合作方用户ID |
| nickname |
string |
Y |
投票发布者,合作方用户昵称 |
| title |
string |
Y |
投票主题 |
| label |
string |
Y |
投票标签 |
| op |
string |
Y |
选项,最多可添加10个选项,json格式,比如 ["aaa","bbb"],aaa为第一个选项,bbb为第二个选项 |
| type |
int |
Y |
类型,0为单选,1为多选 |
| optional |
int |
Y |
若为单选则传1,多选则传的值为多少表示可以选几项 |
| answer |
string |
N |
答案,设置第几项为答案,传入 "0" 表示第一个选项为正确答案,传入 "0,2" 表示第一和第三项为正确答案,不设置答案则传空字符串 |
| image |
file |
N |
若要上传图片作为题目,则传入图片 |
| options |
array |
N |
可选参数,status:0表示发布状态,3表示预发布状态 |
结束投票
api名称:course.votes.end,SDK对应方法:courseVoteEnd
| 名称 |
类型 |
必选 |
描述 |
| vid |
int |
Y |
投票ID |
| showResult |
int |
Y |
是否显示投票结果,0为不显示,1为显示 |
| uid |
string |
Y |
投票结束者,合作方用户ID |
| nickname |
string |
Y |
投票结束者,合作方用户昵称 |
发布预发布的投票
- api名称:
course.votes.emit,SDK对应方法:courseVoteEmit
应用参数说明
| 名称 |
类型 |
必选 |
描述 |
| vid |
int |
Y |
投票ID |
| course_id |
int |
Y |
课程ID |
删除投票
api名称:course.votes.delete,SDK对应方法:courseVoteDelete
| 名称 |
类型 |
必选 |
描述 |
| vid |
int |
Y |
投票ID |
修改投票
api名称:course.votes.update,SDK对应方法:courseVoteUpdate
| 名称 |
类型 |
必选 |
描述 |
| vid |
int |
Y |
投票ID |
| options |
array |
Y |
要更新的投票信息,title(投票标题),label(投票标签),op(投票选项),type(类型,0为单选,1为多选),optional(若为单选则传1,多选则传的值为多少表示可以选几项),answer(答案,设置第几项为答案,传入 "0" 表示第一个选项为正确答案,传入 "0,2" 表示第一和第三项为正确答案,不设置答案则传空字符串),image(若要上传图片作为题目,则传入图片) |