情感计算服务协议

依赖生物数据基础分析服务,提供注意力、放松度、压力值计算等服务。

[!NOTE] 服务需要在管理后台开通才能使用。

服务 操作 备注
affective start 启动、初始化情感计算服务
subscribe 订阅实时情感计算数据
unsubscribe 取消订阅实时情感计算数据
report 获取当前情感计算云计算服务报表
finish 结束某云计算服务

Affective Start

启动情感云计算服务。

Request

{
    "services": "affective",
    "op": "start",
    "kwargs": {
        "cloud_services": [
            cloud_service1, # 云计算服务类型,attention、relaxation、pressure等
            cloud_serviceN
        ]
    }
}

Response

{
    "code": 0,
    "request": {
        "services": "affective",
        "op": "start"
    },
    "data": {
        "cloud_service": [
            cloud_service1, # 已启动的云计算服务类型
            cloud_serviceN
        ]
    }
}

Affective Subscribe

订阅情感云计算服务实时数据。分析返回值为可选服务,如果你需要实时接收分析返回的值,则开启此订阅,并配置要返回的参数。具体参数见下表。

  • 注意:Subscribe有两种Response
    • 订阅成功Response
    • 订阅数据Response

注意:服务需要在后台开通相关权限才可访问。

Subscribe Request 结构体

{
    "services": "affective",
    "op": "subscribe",
    "kwargs": {
        cloud_service1: [   # 云计算服务类型,attention、relaxation、pressure等
            data_type1, data_type2, data_typeN  # 数据类型,详见情感云计算服务 参数 列
        ],
        cloud_serviceN: [
            data_type1, data_type2, data_typeN
        ]   
    }
}

Subscribe 结构体

订阅状态 Response 订阅成功后的状态返回值。会返回所有正在订阅中的计算服务。

{
    "code": 0,
    "request": {
        "services": "affective",
        "op": "subscribe"
    },
    "data": {
        "sub_" + cloud_service1 + "_fields": [   # cloud_service1: 云计算服务类型,attention、relaxation、pressure等
            data_type1, data_typeN, # 已订阅数据,详见情感云计算服务参数列
        ]
        "sub_" + cloud_serviceN + "_fields": [
            data_type1, data_typeN,
        ]
    }
}

订阅数据 Response

返回的数据取决于 Affective Subscribe 时设置的数据。

情感云计算实时返回数据服务和参数项

服务类型(cloud_service) 数据类型(data_type) 类型 取值范围 说明
attention attention float [0, 100] 注意力值,数值越高代表注意力越高
attention_chd attention_chd float [0, 100] 儿童注意力值,数值越高代表注意力越高
relaxation relaxation float [0, 100] 放松度值,数值越高代表放松度越高
relaxation_chd relaxation_chd float [0, 100] 儿童放松度值,数值越高代表放松度越高
pressure pressure float [0, 100] 压力水平值,数值越高代表压力水平越高
pleasure pleasure float [0, 100] 愉悦度值,数值越高代表情绪愉悦度越高
arousal arousal float [0, 100] 激活度值,数值越高代表情绪激活度越高
sleep sleep_degree float [0, 100] 睡眠程度,数值越小代表睡得越深
sleep_state int {0, 1} 睡眠状态,0 表示未入睡,1 表示已入睡
{
    "code": 0,
    "request": {
        "services": "affective",
        "op": "subscribe"
    },
    "data": {
            cloud_service1: {   # 云计算服务数据类型,attention、relaxation、pressure等
                data_type1: data1,  # 数据类型、数据包,详见情感云计算服务数据表
                data_typeN: dataN,
            },
            cloud_serviceN: {
                data_type1: data1,
                data_typeN: dataN,
            }
        }
    }
}

Affective Unsubscribe

取消订阅情感云计算服务实时数据。

Unsubscribe Request 结构体

{
    "services": "affective",
    "op": "unsubscribe",
    "kwargs": {
        cloud_service1: [   # 云计算服务类型,attention、relaxation、pressure等
            data_type1, data_type2, data_typeN  # 数据类型,详见情感云计算服务参数列
        ],
        cloud_serviceN: [
            data_type1, data_type2, data_typeN
        ]   
    }
}

Unsubscribe Response 结构体

{
    "code": 0,
    "request": {
        "services": "affective",
        "op": "unsubscribe"
    },
    "data": {
        "sub_" + cloud_service1 + "_fields": [   # cloud_service1: 云计算服务数据类型,attention、relaxation、pressure等
            data_type1, data_typeN, # 已订阅数据,详见情感云计算服务数据表参数列
        ]
        "sub_" + cloud_serviceN + "_fields": [
            data_type1, data_typeN,
        ]
    }
}

Affective Report

获取云计算服务数据报表。返回从服务开始到执行此操作区间的所有值的分析报表。具体可返回的报表结果见下表。

情感计算报表调用时间间隔

[!NOTE]

  • 会话过程中或结束时若已经接收到(subscribe) 达到次数,则可调用,否则返回值为空或0。
  • Report为阶段性数据,会清空前阶段数据,请开发者尽量控制调用频次(建议只在使用结束时调用一次)。
类别 需要收到subscribe次数 调用间隔
attention 10 2min
attention_chd 10 2min
relaxation 10 2min
relaxation_chd 10 2min
pressure 10 2min
arousal 10 2min
pleasure 10 2min
sleep 20 3min

情感云计算服务数据报表

类别 参数 类型 取值范围 说明
attention attention_avg float [0, 100] 注意力平均值
attention_rec list[float] [0, 100]*k, (k≥10) 注意力全程记录
attention_chd attention_avg float [0, 100] 儿童注意力平均值
attention_rec list[float] [0, 100]*k, (k≥10) 儿童注意力全程记录,横坐标点间间隔为0.8s
attentive_duration int [0, +∞) 专注状态时长,单位:秒
distracted_duration int [0, +∞) 分心状态时长,单位:秒
normal_duration int [0, +∞) 普通状态时长,单位:秒
relaxation relaxation_avg float [0, 100] 放松度平均值
relaxation_rec list[float] [0, 100]*k, (k≥10) 放松度全程记录
relaxation_chd relaxation_avg float [0, 100] 儿童放松度平均值
relaxation_rec list[float] [0, 100]*k, (k≥10) 儿童放松度全程记录,横坐标点间间隔为0.8s
relaxed_duration int [0, +∞) 放松状态时长,单位:秒
nervous_duration int [0, +∞) 紧张状态时长,单位:秒
normal_duration int [0, +∞) 普通状态时长,单位:秒
pressure pressure_avg float [0, 100] 压力水平平均值
pressure_rec list[float] [0, 100]*k, (k≥10) 压力水平全程记录
pleasure pleasure_avg float [0, 100] 愉悦度平均值
pleasure_rec list[float] [0, 100]*k, (k≥10) 愉悦度全程记录
arousal arousal_avg float [0, 100] 激活度平均值
arousal_rec list[float] [0, 100]*k, (k≥10) 激活度全程记录
sleep sleep_curve list[float] [0, 100]*k, (k≥20) 睡眠曲线,横坐标为8s一个点。连续描绘整个小睡过程的睡眠程度。该值越小表示越接近深睡;该值越大表示越接近清醒
sleep_point int [0, +∞) 入睡点时间轴索引,用于标记入睡点。对应睡眠曲线数组的下标,表示那个数据点用户入睡
sleep_latency int [0, +∞) 入睡用时,单位秒
awake_duration int [0, +∞) 清醒时长,单位秒
light_duration int [0, +∞) 浅睡时长,单位秒
deep_duration int [0, +∞) 深睡时长,单位秒

Report Request 结构体

{
    "services": "affective",
    "op": "report",
    "kwargs": {
        "cloud_services": [
            cloud_service1, # 云计算服务数据类型,attention、relaxation、pressure等
            cloud_serviceN
        ]
    }
}

Report Response 结构体

{
    "code": 0,
    "request": {
        "services": "affective",
        "op": "report"
    },
    "data": {
        cloud_service1: {   # 生物数据类型,attention、relaxation、pressure等
            data_type1: data1,  # 数据类型、数据包 详见情感云计算服务数据报表
            data_typeN: dataN,
        },
        cloud_serviceN: {
            data_type1: data1,
            data_typeN: dataN,
        }
    }
}

Affective Finish

结束某情感云计算服务。

[!WARNING]

  • 服务用完后需及时调用 finish,如果不及时调用,我们会认为服务未停止,将会继续计费。
  • 服务的 finish 会在会话结束时自动调用,但不推荐使用 session close 来结束服务,应当先结束服务再关闭会话。

Finish Request 结构体

{
    "services": "affective",
    "op": "finish",
    "kwargs": {
        "cloud_services": [
            cloud_service1, # 生物数据类型,attention、relaxation、pressure等
            cloud_serviceN
        ]
    }
}

Finish Response 结构体

{
    "code": 0,
    "request": {
        "services": "affective",
        "op": "finish"
    },
    "data": {
        "cloud_service": [
            cloud_service1, # 生物数据类型,attention、relaxation、pressure等
            cloud_serviceN
        ]
    }
}
© Entertech 2019 all right reserved,powered by Gitbook该文件修订时间: 2019-11-29 06:38:15

results matching ""

    No results matching ""