faceLivenessVerify

解释:H5活体检测-视频活体检测,录制并上传的视频,会在云端进行随机抽帧分析,并得出最终的活体检测分数。

最低支持版本 3.20.11 。

方法参数:ObjectObject 参数说明

参数名参数类型是否必填说明
video_base64stringbase64 编码后的视频数据(视频限制:最佳为上传 5-15s 的 mp4 文件。视频编码方式:h264 编码;音频编码格式:aac,pcm 均可。)
session_idstring语音校验码会话 ID,使用此接口的前提是已经调用了语音校验码接口。语音校验码作为辅助性质的验证条件,是一个可选项,如果应用场景比较嘈杂或方言口音比较重,可以不使用语音验证。
successFunction接口调用成功后的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

返回值参数说明

参数名参数类型说明
scorenumber活体检测分数。此分数为视频分析结果,不包含语音验证结果,语音验证需开发基于自己的业务需求做判断。
thresholdsArray阈值参考,实际业务应用中,请以 阈值判定通过,可直接选择不同误识别率的阈值,无需对应具体的分值,选择阈值参数即可。
codeObject语音校验码信息
pic_listArray抽取图片信息列表

code参数说明

参数名参数类型说明
createstring生成的校验码
identifystring语音识别出来的校验码,通过 create 和 identify 两个字段的对比,可以判断上传的视频是否为现成录制。create 和 identify 两个字段的对比逻辑需要开发者基于自身业务逻辑进行判断和开发。

pic_list参数说明

参数名参数类型说明
face_idstringface 唯一 ID
picstringbase64 编码后的图片信息

示例代码

  1. swan.ai.faceLivenessVerify({
    video_base64: '',
    session_id: '',
    success(res) {
    console.log('res');
    }
    });

返回示例

  1. {

    err_no:0,
    err_msg: 'success',
    result: {
    score: 0.984654366,
    thresholds: {
    "frr_1e-4": 0.05, //万分之一误识别率的阈值
    "frr_1e-3": 0.3, //千分之一误识别率的阈值
    "frr_1e-2": 0.9 //百分之一误识别率的阈值
    },
    code: {
    "create": "5789",
    "identify": "5789"
    },
    pic_list: [
    {
    "face_id": 5745745747,
    "pic": "gsagaheryzxv..."
    },
    {
    "face_id": 5745745747,
    "pic": "gsagaheryzxv..."
    }
    ]
    },
    "timestamp": 1509611848,
    "cached": 0,
    "serverlogid": "2248375729"
    }

语音识别词法分析