1. 设备接口说明

1.1. flora接口说明

参考github的说明 flora

1.2. 蓝牙接口说明

YodaOS 上，蓝牙统一被bluetooth_service接管，通过flora和蓝牙服务通讯，实现蓝牙操作。蓝牙服务在系统的源码路径如下：

frameworks/native/services/bluetooth_service

在目录frameworks/native/services/bluetooth_service/demo 下有一个测试程序和监控程序，测试程序是测试蓝牙服务提供的接口 bluetooth_test.c ，监控程序bluetooth_monitor.c，是打印蓝牙服务接收到到消息，用来程序调试用。

采用flora发送和接收消息。

1.2.1. A2DP 高质量音频数据传输的协议 source 操作

调用flora库的接口给bluetooth_service

flora_agent_post(agent, "bluetooth.a2dpsource.command", msg, FLORA_MSGTYPE_INSTANT)

msg的消息类型如下：

{
    name:"Rokid-Me-9999zz",
    proto:"A2DPSOURCE",
    command:"",    
}

command的取值类型：

类型	意义
"ON"	打开设备
"OFF"	关闭设备
"DISCONNECT_PEER"	断开链接点
"DISCOVERY"	搜索蓝牙设备
"GETSTATE"	获取当前状态

GETSTATE调用的是flora的同步接口，参考如下：

152      flora_call_result result = {0};
153    if (flora_agent_call(agent, "bluetooth.a2dpsource.command", msg, "bluetoothservice-agent", &result, 0) == FLORA_CLI_SUCCESS) {
154    if (result.data && result.ret_code == FLORA_CLI_SUCCESS) {
155                     const char *buf = NULL;
156                     caps_read_string(result.data, &buf);
157                     printf("data :: %s\n", buf);
158                 }  
159   flora_result_delete(&result);
}
160

1.2.2. A2DP 高质量音频数据传输的协议 sink 操作

调用flora库的接口给bluetooth_service

flora_agent_post(agent, "bluetooth.a2dpsink.command", msg, FLORA_MSGTYPE_INSTANT)

msg的消息类型如下：

{
    name:"Rokid-Me-9999zz",
    proto:"A2DPSINK",
    command:"",    
}

1.3. 灯效接口说明

YodaOS对于AVS灯效的支持依靠lightservice支持，lightservice的源码路径：

frameworks/native/services/lightservice

控制灯效的接口如下，通过flora向lightservice发送"rokid.light.animation"以及msg消息，例如唤醒灯效：

int degree = 360;
Client::connect("unix:/var/run/flora.sock", &cb, 0, cli)
shared_ptr<Caps> msg = Caps::new_instance();
msg->write("awake");
msg->write(degree);

cli->post("rokid.light.animation", msg, FLORA_MSGTYPE_INSTANT);

msg消息值和对应的说明

函数名	参数	说明
active	int degree	Listening Start
thinking	NULL
speaking	NULL
idle	NULL
micOn	NULL	Microphone on
micOff	NULL	Microphone off
alert	NULL	Timer/Alarm/Reminder
alertShort	NULL	Timer Short/Alarm
alertDismiss	NULL
incomingNotification	NULL
queuedNotification	NULL
noNotification	NULL
doNotDisturb	NULL
btConnectState	NULL	Bluetooth connect
error	NULL	error
volume	double value value = [0, 1]	Volume setting
boot	NULL	starting up
bootEnd	NULL	finish starting up
config	NULL	wifi config
configEnd	NULL	finish wifi config

1.4. 本地音效接口说明

通过调用rplayer 播放本地音频文件进行声音提示。接口说明参见rplayer

yim-avs进程的音效文件都放在源代码目录：frameworks/yimo/res

音频文件在运行环境中的目录路径为：/data/yimo/res

设备接口说明