arcs/modules/lschat/samples/session_voice/chat_vlume

.. _chat_volume_sample:

音量设置
######################

概述
****
该示例程序介绍如何通过会话来设置设备音量

.. toctree::
   :hidden:

   ../../sample_build

.. include:: ../../sample_build.rst

调用方法
********
- 初始化lsc服务，并设置设备ID、产品ID、secret ID

  .. code-block:: c

        lsc_config_t cfg = {
            .device_id = DEVICE_ID_STRING,
            .product_id = PRODUCT_ID_STRING,
            .secret_id = SECRET_ID_STRING,
        };        
        lsc_init(lsc_config_t *cfg);

- 注册lsc事件回调函数，发起连接，并通过回调函数获取连接结果

  .. code-block:: c

        static void lsc_event_cb(lsc_event_e evt, void *data, uint32_t size, void *usr)
        {
            //获取事件
        }

        lsc_add_callback(LSC_CONNECTED | LSC_DISCONNECTED | LSC_CLOUD_AUTH_FAILD | LSC_GOT_TOKEN, lsc_event_cb, NULL);
        lsc_connect();

- 激活云端音乐技能

  .. code-block:: c

      lsc_activate_music();

- 初始化闲聊会话

  .. code-block:: c

      session_voice_init()

- 注册回调函数，云端返回的结果会以事件的形式下发

  .. code-block:: c

      static void voice_event_cb(session_voice_event_e evt, void *data, uint32_t size, void *usr)
      {
          //获取事件
      }
      session_voice_add_evt_callback(voice_event_cb, SESSION_VOICE_GOT_VAD | SESSION_VOICE_TTS | SESSION_VOICE_IAT | SESSION_VOICE_AIUI_CTRL, NULL);

- 设置会话参数，使能云端vad功能，并配置设备ID

  .. code-block:: c

      session_voice_config_t config = {
      .vad_enable = true,
      .device_id = "F97CE114C70DE8E2",
    };
    session_voice_set_config(&config);

- 启动会话，并上传语音数据

  .. note:: set_vol_20_inc_file[]数组中存放的是录音数据("音量设置为20")，格式为16Khz, 16bit单通道PCM

  .. code-block:: c

      session_voice_start();
      mock_record_audio_stream_send((uint8_t *)set_vol_20_inc_file, sizeof(set_vol_20_inc_file));

- 设置音量，并获取音量命令以及大小

  .. note:: 获取到的命令中，包含有【音量设置命令关键字：音量大小】

  .. code-block:: c

      static void voice_event_cb(session_voice_event_e evt, void *data, uint32_t size, void *usr)
      {
	    case SESSION_VOICE_AIUI_CTRL:
		    LISA_NLOGI("SESSION_VOICE_AIUI_CTRL : [%s] ", data);
            break;
      }

示例中所使用的API文档见 ::ref:`session_voice`