如何测试在线教室网络环境
多贝云提供「在线教室环境测试工具」,用于测试用户是否满足在线上课的基本条件。
如果你的机构有开发能力,可以添加回调,来追踪或统计用户信息。
由于chrome60及以上版本对flash做了限制,在使用http协议时无法获取麦克风及摄像头,建议使用https协议。
基本用法(无回调)
- 让用户直接访问https://api.duobeiyun.com/ittest/;
- 页面打开后按照提示操作,开始测试,测试需要2分钟左右;
- 测试完毕后会显示测试结果及建议。
高级用法(有回调)
- 机构提供一个用于测试的页面,在这个页面中,用<iframe>的方式嵌入在线教室环境测试工具页面
- 通过在在线教室环境测试工具的URL上添加特定查询字符串,可以在测试完成后将测试结果以json形式提交到特定回调URL上,并在回调时可以指定特定参数来区分每次调用。
例如:
<iframe src="SAMPLE_URL" width="960" height="600" style="border:none;overflow: hidden;"></iframe>
回调样例
SAMPLE_URL为回调URL,例如:
https://api.duobeiyun.com/ittest/content.html?result=CALLBACK_URL&lang=en&uid=123456&KEY=VALUE
注意不要漏掉问号前面的“/”
https://api.duobeiyun.com/ittest/content.html?result=CALLBACK_URL&lang=en&uid=123456&KEY=VALUE
回调参数
1. 指定回调URL
在URL后添加查询字符串result=CALLBACK_URL,可以指定回调时提交结果的URL。URL不可省略http://或https://
2. 选择语言
在URL后添加查询字符串lang=LANG,可以选择不同语言的界面。LANG取值zh时为中文,取值en时为英文。
3. 自定义键值
在访问测试工具URL后添加任意个自定义查询字符串KEY=VLAUE,在回调时会添加相同的查询字符串KEY=VALUE到回调URL上。用该方法课实现如追踪和统计用户ID等自定义功能。
4. 自定义颜色
在URL后添加查询字符串mainColor=COLOR,可自定义界面颜色,COLOR取值为16进制颜色值,例如mainColor=F5D220
5. 可选择是否测试麦克风及摄像头
在URL后添加查询字符串testCamAndMic=VALUE,可选择是否测试麦克风及摄像头,VALUE取值为true或false,例如testCamAndMic=false
6. 可选择是否测试摄像头
在URL后添加查询字符串testCam=VALUE,可选择是否测试摄像头,VALUE取值为true或false,例如testCam=false
回调结果
测试完成后会触发回调,例如:
https://example.com/test/result?testResult=RESULT_JSON&lang=en&uid=123456&KEY=VALUE
其中testResult为JSON格式的测试结果,一个典型的RESULT_JSON格式如下:
{
"system" : {"returnCode":1, "value":"MacOS X 10.10" },
"browser" : {"returnCode":1, "value":"Firefox 33.0" },
"flash" : {"returnCode":1, "value":"15.0.0" },
"connect" : {"returnCode":1, "value":"98ms" },
"delay" : {"returnCode":1, "value":"32ms" },
"bandWidth" : {"returnCode":1, "value":"> 30KB/s" },
"sound" : {"returnCode":2, "value":"未检测到声音" },
"mic" : {"returnCode":1, "value":"已检测到声音" },
"camera" : {"returnCode":2, "value":"未检测到视频" }
}
RESULT_JSON中的字段与含义如下表所示:
字段含义
system操作系统信息
browser浏览器信息
flashflash版本
connect网络连接信息
delay网络延迟信息
bandRank带宽延迟信息
sound音频播放信息
mic麦克风信息
camera摄像头信息
每个字段包含两个子键:returnCode和value。其中:
returnCode表示测试结果,为1时表示满足教室使用要求,为2时表示不满足教室使用要求。
value表示相应字段的具体信息。