多媒体 JS 调用函数

讯飞语音播放

传入需要播放的文本，如果此时有播视频，就关掉视频，显示黑屏

void playVoice(String callText)

/**
 * 文字语音合成
 * @param callText 需要播放的文字
 */
@JavascriptInterface
public void playTextVoice(String callText)

/**
 * 讯飞多音字接口，特殊符号加到多音字前
 * 比如“单”需要读成“善”，需要在“单”字前加入特殊符号，并把特殊符号传入接口第二个参数
 *
 * @param callText      叫号内容
 * @param specialSymbol 特殊字符串
 */
// 网页叫号回调
@JavascriptInterface
public void playVoice(String callText, String specialSymbol)

/**
 * 停止叫号，清除语音队列
 */
@JavascriptInterface
public void stopVoice()

检测 URL 或 IP 连通性

/**
 * 检测url连通性
 * @param url 需要检测的URL或IP
 * @return 结果码：0是可连通，非0都是不可连通
 */
public int checkConnectivity(String url) {
    return CurlUtil.checkConnectivity(url);
}

获取终端时间

获取终端日期，格式： 2013-09-08 07:06 6（1~7 7 代表周日）

String getDateTime()

音量

/**
 * 设置音量
 *
 * @param value 音量值
 */
@JavascriptInterface
public void setVolume(int value)
    
/**
 * 获取音量
 *
 * @return 音量值
 */
@JavascriptInterface
public int getVolume()

电子医保凭证

需要在设备的 /sdcard/shine/electronic.json 文件中配置解密电子医保凭证相关数据，例如：

{
    "businessType": "01101",
    "deviceType": "SelfService",
    "officeId": "9015",
    "officeName": "门诊收费室",
    "operatorId": "LRY002", 
    "operatorName": "自助机2", 
    "orgId": "H43018100218",
    "tradingServerIp": "xxxxxx",
    "tradingUrl": "http://xxxxxx/localcfc/api/hsecfc/localQrCodeQuery",
    "transType": "ec.query"
}

其中 orgId、tradingServerIp、tradingUrl 三个字段是必须的，其他字段可以默认不变

/**  
 * 电子医保凭证数据<br>  
 * 解密成功会调用前端onRawInput方法，传入解密后的数据；<br>  
 * 解密失败会调用前端nationEcTransError方法，传入错误码和错误提示；<br>
 *  
 * @param code 电子社保卡序号  
 */  
@JavascriptInterface  
@android.webkit.JavascriptInterface  
public void nationEcTrans(String code)

读卡拦截

/**
 * 设置有效卡号，只接收这部分卡号
 * @param code 卡号
 */
@JavascriptInterface
public void setValidCardCode(String[] code)
        
/**
 * 调用该接口设置需要拦截的卡号，后续再收到该卡号，不会通知页面
 *
 * @see Callobject#clearInterceptCardCode()
 * @param code 卡号
 */
@JavascriptInterface
public void setInterceptCardCode(String code) 

/**
 * 调用该接口拦截所有卡号
 */
@JavascriptInterface
public void interceptAllCardCode() 
    
/**
 * 清空需要拦截的卡号
 */
@JavascriptInterface
public void clearInterceptCardCode()

明泰三合一读卡

/**
 * 明泰三合一持续读身份证
 *
 * @param duration 持续读时间(单位秒)
 * @return 该函数是否执行成功
 */
@JavascriptInterface
public boolean readIDCardWithDuration(final int duration)

目前只用到了 strParam1 和 needCode 两个参数

strParam1 配置块地址和扇区号以及密码，格式：010160ffffffffffff

needCode 是否需要读取社保卡区号

void GetChinaIdentityCardInfo(int nUsbHardwardID, String strMethodName, int runTime, String strParam1,String strParam2,boolean needCode)

/**
 * 开始循环读卡
 * @param sector 扇区
 * @param block 块地址
 * @param password 密钥
 * @param passwordType 密钥类型 0-类型A 1-类型B
 * @param needCode 对用GetChinaIdentityCardInfo函数最后一个参数
 * @param deduplication 去重复数据，默认不去重
 *                 
 * @apiNote 回调方式和参数和之前读卡接口一致
 */
@JavascriptInterface
public void startLoopReadCard(int sector, int block, String password, int passwordType, boolean needCode，boolean deduplication)

/**
 * 停止循环读卡
 */
@JavascriptInterface
public void stopLoopReadCard()

读卡器/扫描枪数据回调

info

自2024年11月15日起，读卡器、扫描枪及磁条刷卡器的数据结构和回调接口将统一调整，采用分诊产品组最新提出的标准。自该日期起，所有程序需按照以下定义的回调接口和数据结构进行数据解析。

M1卡/就诊卡

该数据由调用 onRawInput 回调统一为 getReadCardInfo

getReadCardInfo('{"cardType":"1","name":"","gender":"","birth":"","nation":"","cardNumber":"","iDNo":"卡号","needCode":""}@卡号@OK')

社保卡数据回调

未解密

getReadCardInfo('{"cardType":"2","name":"","gender":"","birth":"","nation":"","cardNumber":"","iDNo":"卡号","needCode":"","bankCardNumber":""}@卡号@OK')

已解密

getReadCardInfo('{"cardType":"2","name":"张三丰","gender":"男","birth":"2001-01-01","nation":"汉","cardNumber":"卡号","iDNo":"社会保障号码","needCode":"区号","bankCardNumber":"xxxxxx"}@社会保障号码@OK')

身份证数据回调

getReadCardInfo('{"cardType":"3","name":"张三丰","gender":"男","birth":"2001-01-01","nation":"汉","cardNumber":"卡号","address","xxx","iDNo":"身份证号","needCode":"区号"}@身份证号@OK')

一维码/二维码/磁条卡

getReadCardInfo('{"cardType":"4","name":"","gender":"","birth":"","nation":"","cardNumber":"","address","","iDNo":"卡号","needCode":""}@卡号@OK')

中控读卡器读卡

调用 zkReadIDInfo 接口开始读卡，收到读卡成功回调后可以调用 getIDCardBase64ImgData 接口获取 base64 格式照片数据

可能出现读卡失败的情况：

config.json 配置文件没配置启用中控读卡器
身份证没有放对位置，没有读取到身份证信息

/**
 * 中控读卡器读身份证
 */
@JavascriptInterface
public void zkReadIDInfo() 

/**
 * 获取身份证照片
 * @param id 身份证号
 * @return base64格式的图片数据
 */
@JavascriptInterface
public String getIDCardBase64ImgData(String id)

/**
 * 中控读卡器读IC卡
 *
 * @param mode         读操作模式控制
 *                     Bit 0: 0=Requese idle；1=Request All
 *                     Bit 1: 0=对KEYA进行校验；1=对KEYB进行校验
 *                     进行校验
 * @param blockCount   要读取的块数长度值，即读多少块。取值范围 01-04
 * @param startAddress 要读块的起点地址 Mifare s50 取值范围：十六进制 00-3F 即 0 块到 63 块
 * @param key          12个字符秘钥
 */
@JavascriptInterface
public void zkReadMIFARE(int mode, int blockCount, int startAddress, String key)

/**
 * 中控读卡器读IC卡+身份证
 * 优先读IC卡，IC卡读取失败后读身份证，身份证读取失败后通知页面读卡失败
 * 读卡过程中任意一种卡读成功就停止读卡并通知页面
 *
 * @param mode         读操作模式控制
 *                     Bit 0: 0=Requese idle；1=Request All
 *                     Bit 1: 0=对KEYA进行校验；1=对KEYB进行校验
 *                     进行校验
 * @param blockCount   要读取的块数长度值，即读多少块。取值范围 01-04
 * @param startAddress 要读块的起点地址 Mifare s50 取值范围：十六进制 00-3F 即 0 块到 63 块
 * @param key          12个字符秘钥
 */
@JavascriptInterface
public void zkReadCard(int mode, int blockCount, int startAddress, String key)

读身份证回调

// 读卡成功回调
onIDCardInfoReceived('{"address":"黑龙江=","birth":"1999年02月03日","chinaName":"小小","dateEnd":"2040.03.16","dateStart":"2020.03.16","id":"123330198810012333","issued":"xx县公安局","nation":"汉"}')
// 读卡失败回调
onReadIDCardFailed()

读 IC 卡回调

// 读卡成功回调，读卡器读到的原始数据，可能会存在大小端问题
onZKReadMIFAREReceived('5A2F634')
// 读卡失败回调
onReadMIFAREFailed()

读身份证 +IC 卡

// 读卡成功回调，读卡器读到的原始数据，可能会存在大小端问题
onZKReadMIFAREReceived('5A2F634')
// 读身份证成功回调
onIDCardInfoReceived('{"address":"黑龙江=","birth":"1999年02月03日","chinaName":"小小","dateEnd":"2040.03.16","dateStart":"2020.03.16","id":"123330198810012333","issued":"xx县公安局","nation":"汉"}')
// 读卡失败回调
onZKReadCardFailed()

打印机相关

打印

在 java 层如果没得到返回值，默认传 -1

int PrintXml(String xml)

检查打印机纸

int CheckPaper()

设置切纸方式

/**
 * 设置切纸方式
 * @param type 0全切 1半切，默认全切
 */
public void Fullcut(int type)

打印 base64 图片数据

/**
 * 美松打印机打印base64图片数据
 *
 * @param base64 base64图片数据
 * @return 打印结果
 * 0 成功
 * -1 失败
 */
public int printBase64Image(String base64)

设置课节数据

每次调用该接口都会触发分库操作

int setClassInfo(String classInfo)

获取指定文件数据

String getFileData(String path)

写入数据到指定文件

返回值为是否写入成功

boolean setFileData(String path, String json)

打开拍照（弃用）

void openTakePictureCamera()

打开摄像头

传入参数为预览窗口的位置和大小

void openMediaCamera(int x, int y, int width, int height)

关闭摄像头

/**
 * 关闭摄像头
 */
void closeCamera()

判断摄像头是否可以打开

/**
 * 判断摄像头是否可以打开
 */
boolean isCameraCanOpen()

判断摄像头是否打开

/**
 * 判断摄像头是否打开
 */
boolean isCameraOn()

获取摄像头支持的预览尺寸

/**
 * 获取摄像头支持的预览尺寸
 *
 * @param cameraId 摄像头ID，默认前置0，后置1
 * @return 预览尺寸列表，例如 [{"height":720,"width":1280},{"height":960,"width":1280}]
 *
 */
@JavascriptInterface
public String getSupportedPreviewSizes(int cameraId)

设置摄像头预览尺寸

/**
 * 设置摄像头预览尺寸
 * 设置后下次打开摄像头生效
 * 如果设置的尺寸摄像头不支持，默认设置宽高比相近的分辨率
 *
 * @param width 预览宽度
 * @param height 预览高度
 */
@JavascriptInterface
public void setPreviewSizes(int width, int height)

拍照

/**
 * 拍照
 *
 * @param name 拍照后保存的文件名称，文件保存在/sdcard/SmartClass/assets/img/pictures目录
 * @apiNote 拍照结束后回调 android('{"name":"filename","action":"takePicture","content":"failed"}')<br>
 * filename-图片名称<br>
 * content-拍照结果 failed：拍照失败 finish：拍照完成
 */
@JavascriptInterface
public void takePicture(String name)

图片转 Base64

/**
 * 图片转base64数据
 *
 * @param name 位于/sdcard/SmartClass/assets/img/pictures目录中图片文件名
 * @return  图片base64数据
 */
@JavascriptInterface
public String bmp2Base64(String name)

获取设备 Mac

/**
 * 获取设备Mac
 *
 * @return 设备Mac
 */
String getMac()

获取服务器 IP

/**
 * 获取配置的服务器IP
 *
 * @return 服务器IP
 */
String getServeIp()

播放 MW.wav

/**
 * 播放/sdcard/MediaPlay/MW.wav文件，功能暂时不得而知
 *
 * @param fileContent 不得而知
 */
@JavascriptInterface
public void playMW(String fileContent)

播放完成后会调用页面函数：

playMWFinish()

播放系统音

/**
 * 播放系统提示音
 * @param type 声音类型 1：来电铃声 2：系统提示音 4：闹钟铃声
 *             其他类型无效      
 */
@JavascriptInterface
public void playRingtone(int type)

打开项目配置参数设置页面

/**
 * 打开设置页面
 */
@JavascriptInterface
public void openSettingDialog()

录制视频相关

/**
 * 录制视频
 *
 * @param name 视频文件路径
 *             目前该参数没有被使用。固定路径/sdcard/SmartClass/assets/video/test.mp4
 */
void startRecorder(String name)

/**
 * 停止录制视频
 */ 
void stopRecorder()

录制音频相关

/**  
 * 录制MP3格式音频  
 *  
 * @param fileName 音频文件名称  
 *  
 */
void startMP3Recorder(String fileName)

/**  
 * 停止录制MP3格式音频  
 * @return 音频文件路径 例如：/sdcard/shine/record/record.mp3  
 */
String stopMP3Recorder()

跳转主题管理

// 点击了主题管理按钮后发送该通知
android('{"name":"openZT","action":"openZT","content":"openZT"}')

人脸识别相关

/**
 * 检测人脸识别授权状态
 * @return 是否授权
 */
@JavascriptInterface
public boolean verifyFaceAuthorization()

/**
 * 清空人脸特征码数据库
 * @return 是否成功
 */
@JavascriptInterface
public boolean emptyFacePassDB()
        
/**
 * 下载人脸识别用的所有文件
 * SchoolFTP/$schoolId/classFaceCode/$classId_ks.json
 *
 * @param classId 班级ID，旷视项目该参数无效
 */
@JavascriptInterface
public void downClassFace(String classId)

/**
 * 下载人脸识别用的所有文件，包括 user_ks.json，facepass.db
 * 如果更新facepass.db文件，会重新初始化人脸识别SDK
 *
 * @param roomId 教室ID，旷视项目该参数无效
 */
@JavascriptInterface
public void downRoomFace(String roomId)

/**
 * 通知多媒体user_ks.json地址
 *
 * @param path  user_ks.json路径，旷视项目该参数无效
 * @param index 不得而知，旷视项目该参数无效
 */
@JavascriptInterface
public void setPersons(String path, int index)

/**
 * 打开人脸识别，该接口人脸识别默认使用大库，默认显示人脸框
 *
 * @param x      预览窗口x轴位置
 * @param y      预览窗口y轴位置
 * @param width  预览窗口宽度
 * @param height 预览窗口高度
 */
void openFaceCamera(int x, int y, int width, int height)

/**
 * 打开人脸识别，该接口人脸识别默认使用大库
 *
 * @param x          预览窗口x轴位置
 * @param y          预览窗口y轴位置
 * @param width      预览窗口宽度
 * @param height     预览窗口高度
 * @param showResult 是否显示人脸框
 */
void openFaceCamera(int x, int y, int width, int height, boolean showResult)


/**
 * 打开人脸识别
 *
 * @param x       预览窗口x轴位置
 * @param y       预览窗口y轴位置
 * @param width   预览窗口宽度
 * @param height  预览窗口高度
 * @param classId 课程ID
 *                根据该参数选择对应的人脸识别底库进行识别
 */
void openFaceCameraWithClassId(int x, int y, int width, int height, int classId)

/**
 * 打开人脸识别且不显示人脸识别框
 *
 * @param x          预览窗口x轴位置
 * @param y          预览窗口y轴位置
 * @param width      预览窗口宽度
 * @param height     预览窗口高度
 * @param groupId    底库ID，没有找到对应ID使用默认底库
 */
void openFaceCameraWithoutFaceView(int x, int y, int width, int height, int groupId)

/**
 * 关闭人脸识别
 */
void closeFaceCamera()

/**
 * 控制人脸识别预览窗口是否显示
 *
 * @param isShow 是否显示预览窗口
 */
void setPreviewVisibility(boolean isShow)

/**
 * 人证对比，调用该接口后开启相机预览以及身份证读卡器循环读卡模式
 * <p></p>
 * 读到卡信息后，把身份证照片传入人脸识别SDK进行识别
 * <p></p>
 * 识别后调用页面js函数android('{"name":"recognizeWithIDCard","action":"recognizeWithIDCard","content":""}
 * <p></p>
 * content字段为身份证信息以及人证对比分数：<b>{"Department":"派出所","EffectDate":"办证时间","ExpireDate":"过期时间",
 * "IDNo":"身份证号","address":"地址","birth":"生日","name":"姓名","nation":"汉","sex":"男,"score":"对比分数(float类型)""}</b>
 *
 * @param x      预览窗口x轴位置
 * @param y      预览窗口y轴位置
 * @param width  预览窗口宽度
 * @param height 预览窗口高度
 */
@JavascriptInterface
public void recognizeWithIDCard(int x, int y, int width, int height)


/**
 * 人证对比，调用该接口后开启相机预览，根据传入的身份证号进行人证比对
 * <p></p>
 * 识别后调用页面js函数android('{"name":"recognizeWithIDCard","action":"recognizeWithIDCard","content":""}
 * <p></p>
 * content字段为身份证信息以及人证对比分数：<b>{"Department":"派出所","EffectDate":"办证时间","ExpireDate":"过期时间",
 * "IDNo":"身份证号","address":"地址","birth":"生日","name":"姓名","nation":"汉","sex":"男,"score":"对比分数(float类型)""}</b>
 * <p></p>
 * 如果IDNumber参数无效，对比分数始终是0
 *
 * @param x      预览窗口x轴位置
 * @param y      预览窗口y轴位置
 * @param width  预览窗口宽度
 * @param height 预览窗口高度
 */
@JavascriptInterface
public void startRecogniseWithIDNumber(int x, int y, int width, int height, String IDNumber)

/**
 * 是否用于生成人脸特征码的设备
 */
@JavascriptInterface
public boolean isGenerateFaceFeatureDevice()

/**
 * 生成人脸特征码
 */
@JavascriptInterface
public void generateFaceFeature()

人脸识别配置文件下载回调

// 下载成功人脸识别所需的facepass.db和user_ks.json文件后触发该回调
android('{"name":"downRoomFace","action":"downloadFile","content":"success"}')
// 下载失败人脸识别所需的facepass.db和user_ks.json文件后触发该回调
android('{"name":"downRoomFace","action":"downloadFile","content":"failed"}')

分库回调

// content 缺少人脸特征码人员唯一标识组成的数组
android('{"name":"missFaceTokenPersons","action":"missFaceTokenPersons","content":"[1,2,3]"}')

人脸识别回调

// 识别失败 code 1 识别比分过低 2 没有检测到人脸 4 识别中
android('{"name":"faceCheckNoResult","action":"faceCheckNoResult","content":"","type":"face","code":"code"}')

// 刷卡成功时 type 为 card，content 字段为卡号
// 人脸识别成功时 type 为 face，content 字段为特征码对应的photo_url，如果没有对用的photo_url则为null
android('{"name":"cardCode","action":"cardCode","content":null,"type":"face","code":"0"}')

特征码相关

/**
 * 下载保存人脸特征码的文件，下载成功后直接插入特征码到数据库
 * <p></p>
 * 回调：android('{"name":"downloadFaceFeatureFile","action":"downloadFaceFeatureFile","content":"","code":"0"}')
 * code: 0=下载完成 1=下载失败
 * @param url 文件地址
 */
@JavascriptInterface
public void downloadFaceFeatureFile(String url)
        
/**
 * 插入人脸特征码
 * <p></p>
 * 参数数据格式：[{"faceId":"123123","feature":"12312123"},{"faceId":"123123","feature":"12312123"}]
 *
 * @param feature 特征码数据
 */
@JavascriptInterface
public void insertFeature(String feature)

// 特征码插入结果页面回调 content true 插入成功；false 插入失败
android('{"name":"insertFeature","action":"insertFeature","content":true}')

/**
 * 删除人脸特征码
 * <p></p>
 * 参数数据格式：["id1", "id2"]
 *
 * @param uid 人脸唯一ID
 */
@JavascriptInterface
public void delFeature(String uid)

// 特征码删除结果页面回调 content true 删除成功；false 删除失败
android('{"name":"delFeature","action":"delFeature","content":"true"}')

/**  
 * 查询所有人脸特征码  
 *  
 * @return 是否成功 例子：["123","456"]  
 */
public String queryAllFaceToken()

人脸采集相关

/**
 * 采集人脸
 *
 * @param x x轴位置
 * @param y y轴位置
 * @param width 预览界面宽
 * @param height 预览界面高
 */
@JavascriptInterface
void collectingFace(int x, int y, int width, int height)

/**
 * 采集人脸，不显示位置图片
 *
 * @param x x轴位置
 * @param y y轴位置
 * @param width 预览界面宽
 * @param height 预览界面高
 */
@JavascriptInterface
void collectingFaceWithoutPositionImg(int x, int y, int width, int height)

/**  
 * 自动采集人脸，采集到后自动关闭采集框，保存照片到/sdcard/SmartClass/assets/img/pictures/facePhoto.jpg文件，并回调前端takePicture
 *  
 * @param x      x轴位置  
 * @param y      y轴位置  
 * @param width  预览界面宽  
 * @param height 预览界面高  
 */  
@JavascriptInterface  
@android.webkit.JavascriptInterface  
public void collectingFaceAuto(int x, int y, int width, int height)

人脸采集回调

调用了 collectingFace 接口后，会收到关于人脸位置信息的回调，在 code 为 0 时 才允许执行采集动作

// code参数说明 0 位置正确 1 人脸过多 2 请往右移 3 请往左移 4 请往下移 5 请往上移 6 请往前移
android('{"name":"collectingFace","action":"collectingFace","code":"code"}')

图片转特征码

/**
 * 图片转特征码
 * @param name 图片路径
 */
void getFaceToken(String name)

页面调用完该接口，多媒体程序把生成结果通过网页接口传回：

// facetoken 为结果；-1-参数有问题的时候返回 1-没有识别到人脸 2-图片质量不合格
android('{"name":"getFaceToken","action":"getFaceToken","content":["facetoken"]}')

/**
 * 图片转人脸特征码
 * @param name 图片路径
 */
void getFaceFeature(String name)

// content 为结果；-1-参数有问题的时候返回 1-没有识别到人脸 2-图片质量不合格
android('{"name":"getFaceFeature","action":"getFaceFeature","content":""')

测温相关

/**  
 * 获取温度
 * 
 * @return 温度值 比如：25.5  
 */
@JavascriptInterface  
String getTemperatureValue()


/**
 * 开始循环获取温度数据
 *
 * @param delay 每隔多少ms获取一次，推荐不低于300
 * @return 是否成功
 */
@JavascriptInterface
boolean loopGetTemperature(int delay)

/**
 * 开始循环获取温度数据
 *
 * @param delay 每隔多少ms获取一次，推荐800~1200
 * @param warningTemperatureThreshold 报警温度阈值，超过该温度后显示框变成橘色
 *                                    如果传入的参数无效，使用默认值36.9      
 * @return 是否成功
 */
@JavascriptInterface
boolean loopGetTemperature(int delay, String warningTemperatureThreshold)

/**
 * 开始循环获取温度数据，基于gpio上的设备检测
 *
 * @param delay 每隔多少ms发送一次，推荐100~300
 */
@JavascriptInterface
public void loopGetTemperatureWithGpio(int delay) 

/**
 * 获取温度数据
 *
 * @return 是否获取成功
 */
@JavascriptInterface
public boolean getTemperature()

/**
 * 停止循环获取温度数据
 */
@JavascriptInterface
void stopLoopGetTemperature()

/**
 * 根据phone_url获取温度
 *
 * @param phoneUrl 学生对象对应的phone_url
 * @return 温度数据
 */
@JavascriptInterface
String getTemperature(String phoneUrl)

温度数据回调

android(android('{"name":"temperature","action":"temperature","content":"温度数值"}')）

班牌相关

/**
 * 加载页面
 *
 * @param url 页面地址
 */
@JavascriptInterface
public void loadUrl(String url)

/**
 * 获取学校ID
 *
 * @return 学校ID
 */
@JavascriptInterface
public String getSchoolId()

/**
 * 设置学校ID
 * 调用该接口后会去下载服务器的pw文件
 * 下载成功后立马授权
 *
 * @param schoolId 学校ID
 */
@JavascriptInterface
public void setSchoolId(String schoolId)

文件相关

/**
 * 写内容到文件
 *
 * @param filePath 文件绝对路径，如果不存在则自动创建，建议使用/sdcard/shine/web作为根目录
 * @param content  写入内容
 * @param append   是否追加写入
 * @return 写入结果
 */
@JavascriptInterface
public boolean writeFile(String filePath, String content, boolean append)

/**
 * 读文件
 *
 * @param filePath 文件绝对路径
 * @return 读取内容
 */
@JavascriptInterface
public String readFile(String filePath)

/**
 * 文件是否存在
 *
 * @param filePath 文件绝对路径
 * @return 文件是否存在
 */
public boolean isFileExists(String filePath)

/**
 * 下载文件
 *
 * @param name      文件名
 * @param paths     文件路径
 * @param md5       文件md5
 * @param needDel   不得而知
 * @param isPicture 是否是图片
 */
public void downLoad(String name, String[] paths, String[] md5,boolean needDel, boolean isPicture)

/**
 * 下载文件
 *
 * @param name      文件名
 * @param paths     文件路径
 * @param md5       文件md5
 * @param needDel   不得而知
 */
@JavascriptInterface
public void downLoad(String name, String[] paths, String[] md5, boolean needDel)

/**
 * 上传文件
 *
 * @param src  文件名
 * @param path 文件路径
 * @param type 文件类型
 */
@JavascriptInterface
public void uploadFile(String src, String path, int type) 

/**
 * 删除班牌项目中的图片
 *
 * @param paths 图片路径
 *              多媒体会在路径前拼接/sdcard/SmartClass/assets/img/
 */
@JavascriptInterface
public void deleteImg(String[] paths)

/**
 * 删除文件
 *
 * @param src 文件的相对路径，不要以/开头
 *            例如：assets/img/post/101/4.mp4
 *            下载结果通知action为deleteFile
 *            content为结果码 0-成功；10301-无效参数；10302-删除失败
 */
@JavascriptInterface
public void deleteFile(String src)

/**
 * 批量删除文件
 *
 * @param paths 文件的相对路径数组，路径不要以/开头
 *              例如：{"assets/img/post/101/4.mp4", "assets/img/post/101/5.mp4"}
 *              每删除一个文件回调一次，删除结果通知action为deleteFile
 *              content为结果码 0-成功；10301-无效参数；10302-删除失败
 */
@JavascriptInterface
public void deleteFiles(String[] paths)

/**
 * 检测文件是否存在
 *
 * @param path 文件的相对路径数组，路径不要以/开头
 *              例如："assets/img/post/101/5.mp4"
 *              
 * @return true：存在 false：不存在 
 */
@JavascriptInterface
public boolean checkFileExists(String path)


/**  
 * 获取指定目录下文件列表，包括子目录
 * @param path 文件目录路径 例如：/sdcard/SmartClass/assets/img/post/  
 * @return 文件列表 例如：["/sdcard/SmartClass/assets/img/post/1/15.mp4"]  
 */
@JavascriptInterface  
public String listFilesInDir(String path)

文件下载回调

// 下载FTP文件进度通知
android({name:"downloadProgress",action:"downloadProgress",content:"progress"})

/**
 * 下载结果
 *
 * @param name FTP服务器文件名
 * @param content 下载结果 
 *                success 成功 
 *                failed 失败 
 */
android({name:"file_name",action:"downloadFile",content:"success"})

// 上传FTP文件结果通知
android({name:"file_name",action:"fileUpload",content:"success"})

文件删除回调

/**
 * 删除文件结果通知
 * result 0-成功；10301-无效参数（文件不存在或不是一个文件）；10302-删除失败；
 * file_name 当前删除的文件相对路径
 */ 
android({name:"file_name",action:"deleteFile",content:"result"})

直播相关

/**
 * 开启直播，目前全平台不支持rtmp协议的流
 *
 * @param path 直播流路径
 */
@JavascriptInterface
public void openLive(String path)

/**
 * 开启直播
 *
 * @param path   直播流地址
 * @param x      预览窗口x轴位置
 * @param y      预览窗口y轴位置
 * @param width  预览窗口宽度
 * @param height 预览窗口高度
 */
@JavascriptInterface
public void openLive(String path, int x, int y, int width, int height)


/**
 * 打开直播流，隐藏自带的loading界面
 *
 * @param path   直播流地址
 * @param x      预览窗口x轴位置
 * @param y      预览窗口y轴位置
 * @param width  预览窗口宽度
 * @param height 预览窗口高度
 */
@JavascriptInterface
public void openLiveHideLoadingView(String path, int x, int y, int width, int height)

/**  
 * 开启直播，不显示关闭按钮 
 * @param path   直播流地址  
 * @param x      预览窗口x轴位置  
 * @param y      预览窗口y轴位置  
 * @param width  预览窗口宽度  
 * @param height 预览窗口高度  
 */
@JavascriptInterface  
public void openLiveWithoutCloseBtn(String path, int x, int y, int width, int height)

/**
 * 关闭直播流
 */
@JavascriptInterface
public void closeLive()

直播事件通知

// 识别失败 code 10900 直播流加载成功 10901 直播流加载失败  10902 手动停止直播流
android('{"name":"live","action":"live","content":"","type":"","code":"code"}')

跑马灯相关

/**
 * 播放跑马灯
 *
 * @param content   内容
 * @param startDate 开始日期 "2013-03-27"
 * @param startTime 开始时间 "00:00:00"
 * @param stopDate  停止日期 "2013-05-10"
 * @param stopTime  停止时间 "23:59:00"
 * @param id        任务ID
 */
@JavascriptInterface
public void playText(String content, String startDate, String startTime, String stopDate, String stopTime, int id) 

/**
 * 播放跑马灯
 *
 * @param content     内容
 * @param startDate   开始日期
 * @param startTime   开始时间
 * @param stopDate    停止日期
 * @param stopTime    停止时间
 * @param id          任务ID
 * @param marginLeft  左边距
 * @param marginRight 右边距
 * @param textSize    字体大小
 * @param boldText    字体加粗
 */
@JavascriptInterface
public void playTextWithMargin(String content, String startDate, String startTime, String stopDate, String stopTime, int id,
                               int marginLeft, int marginRight, int textSize, boolean boldText)

/**
 * 停止跑马灯
 *
 * @param id 任务ID
 */
@JavascriptInterface
public void stopText(int id)

/**
 * 显示跑马灯
 */
@JavascriptInterface
public void showText() 
    
/**
 * 隐藏跑马灯
 */
@JavascriptInterface
public void hideText()

门禁相关

/**
 * 开门
 */
@JavascriptInterface
public void openDoor()

/**
 * 关门
 */
@JavascriptInterface
public void closeDoor()

/**
 * 给门禁控制器发送指令
 * 设备安装了门禁控制器后，发送在线检测指令，一般情况下1s内串口会响应在线检测指令
 * 响应内容通过回调页面js函数android('{"name":"serialReceived","action":"serialReceived","content":""}中的content字段返回
 * @param command 门禁控制指令
 *                关门：7F10030000026EAA
 *                开门：7F10030000016DAA
 *                在线检测：7F10050000006AAA
 @see
 <a href="https://www.yuque.com/docs/share/0721bb33-f948-4612-927b-a2646d3c2fb5?#6edd">门禁协议文档</a>
 */
@JavascriptInterface
public void sendDoorLockControlCommand(String command)

mqtt 相关

/**
* mqtt是否连接成功
* @return 是否连接成功
*/
public boolean isMqttConnected()

/**
 * 订阅mqtt主题
 *
 * @param topic mqtt主题
 * @return 是否订阅成功
 */
@JavascriptInterface
public boolean subscribeToTopic(String topic)

/**
 * 解除订阅mqtt主题
 *
 * @param topic mqtt主题
 * @return 是否解除订阅成功
 */
@JavascriptInterface
public boolean disSubscribeToTopic(String topic)

/**
 * 发送mqtt消息
 *
 * @param message mqtt消息
 * @param topic   mqtt主题
 */
@JavascriptInterface
public void sendMqtt(String message, String topic) 

mqtt 连接状态通知

// 连接成功，重新连接成功通知
android('{"name":"mqttConnectComplete","action":"mqttConnectComplete"}')

// 连接断开
android('{"name":"mqttConnectionLost","action":"mqttConnectionLost"}')

屏幕控制相关

/**
 * 关屏
 * @return 结果码 0成功 非0失败
 */
@JavascriptInterface
public int closeScreen()

/**
 * 开屏
 * @return 结果码 0成功 非0失败
 */
@JavascriptInterface
public int openScreen()

腾讯 TRTC 音视频接口

/**
 * 进入房间
 * <br>
 * 调用接口后，您会收到来自 TRTCCloudListener 中的 onEnterRoom(result) 回调：
 * <br>
 * 如果加入成功，result 会是一个正数（result > 0），表示加入房间所消耗的时间，单位是毫秒（ms）。
 * 如果加入失败，result 会是一个负数（result < 0），表示进房失败的错误码。
 * <br>
 * 进房失败的错误码含义请参见<a href="https://cloud.tencent.com/document/product/647/32257">错误码</a>。
 *
 * @param sdkAppId   可以在腾讯云实时音视频控制台（https://console.cloud.tencent.com/rav）获取
 * @param roomId     音视频房间号，自动创建房间，比如 125
 * @param uid        用户名，它是一个字符串
 * @param secretKey  计算签名用的加密密钥
 *                   <p>
 *                   step1. 进入腾讯云实时音视频[控制台](https://console.cloud.tencent.com/rav )，如果还没有应用就创建一个，
 *                   step2. 单击您的应用，并进一步找到“快速上手”部分。
 *                   step3. 点击“查看密钥”按钮，就可以看到计算 UserSig 使用的加密的密钥了，请将其拷贝并复制到如下的变量中
 *                   <p>
 *                   注意：该方案仅适用于调试Demo，正式上线前请将 UserSig 计算代码和密钥迁移到您的后台服务器上，以避免加密密钥泄露导致的流量盗用。
 *                   文档：https://cloud.tencent.com/document/product/647/17275#Server
 * @param startVideo 是否开启视频
 * @param previewViewParams 预览窗口位置参数，localViewRotation 本地图像的顺时针旋转角度，参数只能是0,90,180,270
 *                          比如 {"localViewX":0,"localViewY":100,"localViewWidth":500,"localViewHeight":500,"remoteViewX":0,
 *                          "remoteViewY":500,"remoteViewWidth":300,"remoteViewHeight":300}
 * @return 0：无错误 10401：预览窗口位置参数无效
 */
@JavascriptInterface
public int joinRoom(int sdkAppId, int roomId, String uid, String secretKey, boolean startVideo, String previewViewParams)

/**
 * 离开房间
 * <br>
 * 调用 exitRoom() 接口会执行退出房间的相关逻辑，例如释放音视频设备资源和编解码器资源等。 待资源释放完毕，SDK 会通过 TRTCCloudListener 中的 onExitRoom() 回调通知到您。
 * <br>
 * 如果您要再次调用 enterRoom() 或者切换到其他的音视频 SDK，请等待 onExitRoom() 回调到来之后再执行相关操作。 否则可能会遇到摄像头或麦克风被占用等各种异常问题，例如常见的 Android 媒体音量和通话音量切换问题等等
 */
@JavascriptInterface
public void exitRoom()

/**
 * 暂停/恢复推送本地的视频数据
 * <br>
 * 当暂停推送本地视频后，房间里的其它成员将会收到 onUserVideoAvailable(userId, false) 回调通知 当恢复推送本地视频后，房间里的其它成员将会收到 onUserVideoAvailable(userId, true) 回调通知
 *
 * @param mute true：暂停；false：恢复
 */
@JavascriptInterface
public void muteLocalVideo(boolean mute)
    
/**
 * 开启本地视频的预览画面，并将采集到的画面编码并发送出去
 * <br>
 * 当开始渲染首帧摄像头画面时，您会收到 TRTCCloudListener 中的 onFirstVideoFrame(null) 回调。
 */
@JavascriptInterface
public void startLocalPreview()

/**
 * 停止本地视频采集及预览
 */
@JavascriptInterface
public void stopLocalPreview()

/**
 * 设置 SDK 采集音量
 *
 * @param volume 音量大小，取值0 - 100，默认值为100
 */
@JavascriptInterface
public void setAudioCaptureVolume(int volume)

/**
 * 设置 SDK 播放音量
 * <br>
 * 该函数会控制最终交给系统播放的声音音量，会影响录制本地音频文件的音量大小，但不会影响耳返的音量。
 *
 * @param volume 音量大小，取值0 - 100，默认值为100
 */
@JavascriptInterface
public void setAudioPlayoutVolume(int volume)

事件通知

// 报错 content为错误码
android('{"name":"trtcEvent","action":"onError","content":""}')

// 进入房间 content > 0 时为进房耗时（ms），content < 0 时为进房错误码
android('{"name":"trtcEvent","action":"onEnterRoom","content":""}')

// 远端用户是否存在可播放的音频数据 content为用户标识
android('{"name":"trtcEvent","action":"onUserAudioAvailable","content":""}')

// 远端用户是否存在可播放的主路画面 content为用户标识
android('{"name":"trtcEvent","action":"onUserVideoAvailable","content":""}')

// 离开房间的事件回调 content为离开房间原因，0：主动调用 exitRoom 退房；1：被服务器踢出当前房间；2：当前房间整个被解散
android('{"name":"trtcEvent","action":"onExitRoom","content":""}')

// 远端用户加入房间 content为用户标识
android('{"name":"trtcEvent","action":"onRemoteUserEnterRoom","content":"uid"}')

// 远端用户离开房间 content为用户标识
android('{"name":"trtcEvent","action":"onRemoteUserLeaveRoom","content":"uid"}')

存储签到信息相关

/**
 * 插入签到数据
 * @param signData json格式的签到数据
 */
@JavascriptInterface
public void insertSignData(String signData)

/**
 * 删除指定时间点之前的数据
 * @param timestamp 时间戳
 */
@JavascriptInterface
public void deleteSignLessThanTime(long timestamp)

/**
 * 加载所有签到数据，由于Android和页面之间无法传递大量数据
 * 获取所有签到数据之前需要提前加载
 */
@JavascriptInterface
public void loadAllSigns()

/**
 * 获取所有签到数据
 * @return json格式的签到数据
 */
@JavascriptInterface
public String getAllSigns()

事件通知

// 插入签到数据，content非0为插入失败，此时content表示报错信息
android('{"name":"signData","action":"insert","content":"0"}')

// 删除签到数据，content非0为删除失败，此时content表示报错信息
android('{"name":"signData","action":"deleteSignLessThanTime","content":"0"}')

// 加载所有签到数据，content非0为加载失败，此时content表示报错信息
android('{"name":"signData","action":"loadAllSigns","content":"0"}')

摄像头检测

针对北京交大 3288 设备 USB 摄像头总挂载不上的问题，增加了一块 USBHUB，可以通过串口控制 USB 断电重启。目前是 10s 检测一次，如果检测到摄像头未挂载会通知页面并给 USB 断电，断电指令发送 3s 后发送关狗指令用来给 USB 上电。

如果多次检测都发现摄像头未挂载，每失败一次断电时长加 2s，最长断电间隔 9s。连续失败 5 次后重启设备，并把重启时间记录到 /sdcard/shine/reboot.log 文件中。

事件通知

// video0摄像头状态；content为当前状态，true：video0摄像头挂载，false：video0摄像头未挂载
android('{"name":"video0State","action":"video0State","content":"true"}')

浏览器相关

/**
 * 加载页面
 *
 * @param url 页面地址
 */
@JavascriptInterface
public void loadUrl(String url)


/**
 * reload页面
 */
@JavascriptInterface
public void reload()

/**
 * 预览浏览器打开url
 * 会单独打开一个窗口加载url
 * @param url 页面url
 * @param x      预览窗口x轴位置
 * @param y      预览窗口y轴位置
 * @param width  预览窗口宽度
 * @param height 预览窗口高度
 * @return 是否打开成功
 */
@JavascriptInterface
public boolean openUrlInPreviewWebView(String url, int x, int y, int width, int height)

/**
 * 预览浏览器返回上一页
 */
@JavascriptInterface
public void clickBackInPreviewWebView()

/**
 * 关闭预览浏览器
 */
@JavascriptInterface
public void closePreviewWebView()

//副屏异显
public void loadJSWebPresentation(String url)

串口相关

/**  
 * 发送串口设备控制指令  
 *  
 * @param type    设备类型：  
 *                7-串口灯  
 *                班牌串口灯蓝色灯测试数据：DD55EE000000010099010000003600010000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FF0000FFAABB
 *                独立串口灯蓝灯控制协议：7E0101010000000000FF80AA
 *                独立串口灯红灯控制协议：7E01010200000000FF0083AA
 *                独立串口灯绿灯控制协议：7E010103000000FF000082AA
 *                独立串口灯白灯控制协议：7E0101040000000000FF85AA
 *                独立串口灯关灯控制协议：7E0101050000000000007BAA
 * @param command 指令  
 */
@android.webkit.JavascriptInterface  
public void sendSerialDeviceControlCommand(int type, String command)

GPIO 相关

/**
 * 设置 gpio 模式
 * @param gpio gpio 号
 * @param value 0：输入模式 1：输出模式
 */
public void setGpioDirection(int gpio, int value)

/**
 * 设置 gpio 值
 * @param gpio gpio 号
 * @param value 0：低电平 1：高电平
 */
public void writeGpioValue(int gpio, String value)

摄像头扫描相关

/**  
 * 开始扫码，扫描成功后会通过js回调函数返回扫描结果，回调函数名为android，参数为json格式的扫描结果，格式如下：  
 * {"name":"cardCode","action":"cardCode","content":[1231231],"type":"scanqrcode","code":"0"}
 *  
 * @param x      扫码框的x坐标  
 * @param y      扫码框的y坐标  
 * @param width  扫码框的宽度  
 * @param height 扫码框的高度  
 */   
public void startScan(int x, int y, int width, int height)

/**  
 * 停止扫码  
 */    
public void stopScan()

重启应用

void relaunchApp()

关机通知

// 设备会在关机前5s发送关机通知
android('{"name":"onShutdown","action":"onShutdown"}')

5V 电源控制

/**
 * 重启 5V 电源
 */
windows.CallObject.reset5VPower()

/**
 * 关闭 5V 电源
 */
windows.CallObject.close5VPower()

/**
 * 打开 5V 电源
 */
windows.CallObject.open5VPower()

多媒体 JS 调用函数

讯飞语音播放​

检测 URL 或 IP 连通性​

获取终端时间​

音量​

电子医保凭证​

读卡拦截​

明泰三合一读卡​

读卡器/扫描枪数据回调​

M1卡/就诊卡​

社保卡数据回调​

未解密​

已解密​

身份证数据回调​

一维码/二维码/磁条卡​

中控读卡器读卡​

读身份证回调​

读 IC 卡回调​

读身份证 +IC 卡​

打印机相关​

打印​

检查打印机纸​

设置切纸方式​

打印 base64 图片数据​

设置课节数据​

获取指定文件数据​

写入数据到指定文件​

打开拍照（弃用）​

打开摄像头​

关闭摄像头​

判断摄像头是否可以打开​

判断摄像头是否打开​

获取摄像头支持的预览尺寸​

设置摄像头预览尺寸​

拍照​

图片转 Base64​

获取设备 Mac​

获取服务器 IP​

播放 MW.wav​

播放系统音​

打开项目配置参数设置页面​

录制视频相关​

录制音频相关​

跳转主题管理​

人脸识别相关​

人脸识别配置文件下载回调​

分库回调​

人脸识别回调​

特征码相关​

人脸采集相关​

人脸采集回调​

图片转特征码​

测温相关​

温度数据回调​

班牌相关​

文件相关​

文件下载回调​

文件删除回调​

直播相关​

直播事件通知​

跑马灯相关​

门禁相关​

mqtt 相关​

mqtt 连接状态通知​

屏幕控制相关​

腾讯 TRTC 音视频接口​

事件通知​

存储签到信息相关​

事件通知​

摄像头检测​

事件通知​

浏览器相关​

串口相关​

GPIO 相关​

摄像头扫描相关​

重启应用​

关机通知​

5V 电源控制​

讯飞语音播放

检测 URL 或 IP 连通性

获取终端时间

音量

电子医保凭证

读卡拦截

明泰三合一读卡

读卡器/扫描枪数据回调

M1卡/就诊卡

社保卡数据回调

未解密

已解密

身份证数据回调

一维码/二维码/磁条卡

中控读卡器读卡

读身份证回调

读 IC 卡回调

读身份证 +IC 卡

打印机相关

打印

检查打印机纸

设置切纸方式

打印 base64 图片数据

设置课节数据

获取指定文件数据

写入数据到指定文件

打开拍照（弃用）

打开摄像头

关闭摄像头

判断摄像头是否可以打开

判断摄像头是否打开

获取摄像头支持的预览尺寸

设置摄像头预览尺寸

拍照

图片转 Base64

获取设备 Mac

获取服务器 IP

播放 MW.wav

播放系统音

打开项目配置参数设置页面

录制视频相关

录制音频相关

跳转主题管理

人脸识别相关

人脸识别配置文件下载回调

分库回调

人脸识别回调

特征码相关

人脸采集相关

人脸采集回调

图片转特征码

测温相关

温度数据回调

班牌相关

文件相关

文件下载回调

文件删除回调

直播相关

直播事件通知

跑马灯相关

门禁相关

mqtt 相关

mqtt 连接状态通知

屏幕控制相关

腾讯 TRTC 音视频接口

事件通知

存储签到信息相关

事件通知

摄像头检测

事件通知

浏览器相关

串口相关

GPIO 相关

摄像头扫描相关

重启应用

关机通知

5V 电源控制