连接手机蓝牙启动厂商HMI应用

场景说明

为了简化用户首次连接HiCar的步骤，车机可以在检测到连接手机蓝牙后，直接启动厂商HMI应用。

当支持HiCar的手机与支持HiCar的车机，建立蓝牙连接时，车机侧HiCar SDK和手机侧HiCar App会通过蓝牙RFcomm通道进行数据交互，在确认双方都支持HiCar后手机侧将直接推荐用户使用HiCar，用户在手机侧同意使用HiCar后，车机侧需要直接进入到连接界面（连接码或者扫码连接界面），从而简化用户的首次连接流程。

用户体验路径如下：

1. 手动修改车机蓝牙名称为HiCarTest，用户手机和车机连接蓝牙后，若满足推荐条件，则手机端会出现如下弹窗，询问用户是否体验HiCar（HiCarTest为测试使用车机蓝牙名称，正式使用需要厂商提供蓝牙默认名称，在经过验证后会添加到蓝牙推荐白名单的规则里，白名单生效后现网可正常使用）。

   

2. 若用户点击“同意”，则车机端应该拉起HiCar HMI应用界面（PIN码或二维码界面）；若用户点击“取消”，则车机端不会收到任何回调通知，即无需进行任何动作。

为实现该功能，厂商需根据本章节内容完成功能开发。

图1 交互流程

接口说明

开发步骤

1. 厂商需实现监听蓝牙连接的接口，并在检测到有蓝牙连接时，在HiCar SDK初始化成功的回调中调用HiCarStartBluetoothRecommend方法，传入车机modelID和支持的连接类型 （此处的modelId为完整的8位modelId）。
2. 实现ShowStartPage接口，在此回调方法中跳转到HiCar连接界面（连接码界面或者扫码连接界面）。
3. 蓝牙连接及数据收发需要厂商实现bt_socket_wrapper.h中的接口，即根据此头文件实现bt_socket_wrapper.c 。
   收起

   自动换行

   深色代码主题

   复制

   // 实现结构体内的所有接口，且结构体对象名称必须为g_btRecommendAdapter
   const BtRecommendAdpterOps g_btRecommendAdapter = {
       .InitBtSocket = InitSocket,
       .DeInitBtSocket = DeInitSocket,
       .RegisterBtSocketCallback = RegisterSocketCallback,
       .SendData = ReplyData,
       .UnregisterBtSocketCallback = UnregisterSocketCallback
   };
   
   //RegisterSocketCallback实现建议： 定义全局变量，如g_recvCallback，将callback赋值给g_recvCallback
   int32_t RegisterSocketCallback(BtSocketDataCallback *callback) {
       printf("registerCallback\n");
       if (callback == NULL) {
           printf("callback is null\n");
           return -1;
       }
       g_recvCallback = callback;
       return 0;
   }
   
   //InitSocket实现建议：开始建立蓝牙连接，并监听蓝牙socket发送过来的数据，收到数据时调用，调用g_recvCallback(data),将数据回调给sdk处理
   注：此处为python语句，只展示逻辑
   server_sock = BluetoothSocket(RFCOMM)
   server_sock.bind(("", 0))
   server_sock.listen(1)
   port = server_sock.getsockname()[1]
   advertise_service(server_sock, "HiCarRecommend",
       service_id="fa87c0d0-afac-11de-8a39-0800200c9a66",
       service_classes=["fa87c0d0-afac-11de-8a39-0800200c9a66", SERIAL_PORT_CLASS],
       profiles=[SERIAL_PORT_PROFILE])
   print("listening")
   client_sock, client_info = server_sock.accept()
   print("bluetooth socket connected")
   
   //ReplyData实现建议：在此函数中使用InitSocket函数创建的蓝牙连接 发送数据
   int32_t ReplyData(const char *data)
   {
       if (data == NULL) {
           printf("ReplyData input is invalid.\n");
           return RESULT_ERROR;    // return a NONZERO value
       }
       // 使用InitSocket函数创建的蓝牙连接 发送数据
       // send(socket_created_in_InitSocket_func, data, ...);
       // printf("ReplyData ok, ...\n", ...);
       return RESULT_OK;           // return 0
   }
   
   //UnregisterSocketCallback实现建议：在此函数中注销已注册的函数
   int32_t UnregisterSocketCallback() {
       printf("unregisterCallback");
       g_callback = NULL;
       return 0;
   }
   
   //DeInitSocket实现建议：在此函数中完成断开socket连接的逻辑
   int32_t DeInitSocket() {
      //断开连接 
      return 0;
   }