FWScript 多媒体支持
FWScript 多媒体支持包括如下方面：
让计算机读一段文字，指定一个字符串，让计算机读出来；
播放一段音频或视频，让计算机播放一个音频文件或视频文件
录音，打开录音设施，然后计算机将声音存到指定的文件
对话，设定好要识别的词语或句子，让计算机听您的发音，判断说的是那个词语或句子
显示一个图片，让计算机显示指定的图片文件
打开摄像头录像或拍照，让计算机录像或拍照，输出到指定的文件
图像对比，让计算机比较两张图像，获得相似度
图像特征分析，让计算机比较对一张图像或多张图像进行分析，获得相关特征，如屏幕的亮与黑；灯从亮变黑还是从黑变亮
图像识别，让计算机识别图像，输出指定区域的OCR文字
声音
简单字符串表达式 Simple String Expression，缩写为SSExpr，由下述内容组成：
直接跟随着一串字符
字符串 'xxxx' 或 "xxxxx"
变量 $var （数字变量$0-$9; 或者标准变量如$list）
@变量 @12，或者直接使用@
空，在某些场景下，意味着使用了@，如果@在前面没有赋值，则为未指定
| 功能 | 语句 | 说明 | 举例 |
|---|---|---|---|
| 读一段文字 | Speak Expr Say Expr Speaking Expr | 将后面表达式产生的字符串读出来，或者后面直接写要说的话 | speak "it is " + $name Say this is good @="this is very good" Speak |
| 播放一段音频或视频 | play SSExpr | 播放后面简单字符表达式SSExpr生成的字符串代表的文件 | play d:\tmp\t.wav play $path |
| 让电脑开始录音 | beginrecord | 启动电脑开始录音，直到碰到后面的停止录音命令，然后将录音文件存放到指定目录 | |
| 让电脑开始录音 | endrecord SSExpr | 停止电脑录音 | beginrecord =5s endrecord filename |
| 显示界面让电脑录音 | record SSExpr | 在屏幕的右上角显示一个录音的界面，点击录音按钮开始录音，再点击后停止，点击播放按钮则播放这个录音，点击关闭后将录音好的内容存放到指定目录 | |
| 让电脑听指令 | Listen w1/w2/w3 hear expr | 让电脑识别测试人员说的话，并进行匹配，注意缺省的开头语为字符串“回答”；结果返回一个整数，对应提供的选择顺序。注意后面可以跟随表达式 | |
| 设置电脑听指令的开头语 | Listenheader SSExpr | 设置电脑识别的华语的开头语，如果参数为空，则设置成缺省值（亦即字符串“回答”） |
图像
| 功能 | 语句 | 说明 | 举例 |
|---|---|---|---|
| 选择用于摄像或照相的摄像头 | setcamera d | d为一个整数，表示当前摄像头的系统索引值，一般内置的为0，外接的从1开始。 | |
| 显示一张照片 | showpicture SSExpr | 显示一张图片，后面的简单字符串表达式SSExpr用来指定一个文件名 | |
| 屏幕截图编辑 | snipaste SSExpr cutedit SSExpr | 启动Snipaste，然后让测试人员在屏幕上随意选择区域截图，然后进行编辑，最后存储到指定的测试结果文件中 | |
| 拍照 | takephoto SSExpr | 启动电脑拍照，然后将拍好的文件存放到指定目录，如果无内容，则存放到一个临时生成的文件中。注意，这个指令会将当前拍照的图像自动作为用于比较的图像 | |
| 设置用于比较的图像 | photoAsModel SSExpr | 将后面跟随的文件名作为用于比较的图片，若什么也不跟，则使用@变量 | |
| 设置用于定义显示器屏幕未接通的图像 | phtotoAsBlank SSExpr | 将后面跟随的文件名作为用于定义显示器未接通的图像，如果什么都不跟，则表示使用上面用于比较的图像 | |
| 录像 | beginVCamera，EndVCamera | 启动电脑开始录像，直到碰到后面的结束命令，然后将录像文件存放到指定目录（跟随在beginvcamera后面） | |
| 图像对比 | takePhotoCompare | 让摄像头再拍一张照片，与之前存放的照片进行比较，输出0-100的整数给$$，作为相似度 | |
| 检查是否显示器未连接 | takePhotoCheck | 让摄像头拍一张照片，与之前存放的显示器未连接的照片进行比较，输出0-100的整数给$$，作为相似度 |
| << FWScript 输入输出 | FWScript 调用外部进程 >> |