如何测试在线教室网络环境

最近更新 2017-12-27

多贝云提供「在线教室环境测试工具」，用于测试用户是否满足在线上课的基本条件。

如果你的机构有开发能力，可以添加回调，来追踪或统计用户信息。

由于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表示相应字段的具体信息。