Querying and Subscribing to Status

Querying the Available Space of the Wearable Device

1. Refer to Querying Wearable Device Information to obtain the paired device list and select the device for communications.
2. Call the getDeviceClient method in HiWear to obtain the DeviceClient object.
3. Call the getAvailableKbytes method to obtain the available space of the specified device.

   // Step 2: Obtain the DeviceClient object.
   DeviceClient deviceClient = HiWear.getDeviceClient(this);
   
   // Step 3: Obtain the available space of the specified device.
   if (connectedDevice != null && connectedDevice.isConnected()) {
       deviceClient.getAvailableKbytes(connectedDevice).addOnSuccessListener(new OnSuccessListener<Integer>() {
           @Override
           public void onSuccess(Integer integer) {
               // Return the available storage space (KB) of a specified device.
           }
       }).addOnFailureListener(new OnFailureListener() {
           @Override
           public void onFailure(Exception e) {
           // Process the logic related to the failure to query the available storage space of a specified device.
           }
       });
   }

Querying Other Status

In addition to the available space, other states of the wearable device and health data may be obtained by calling the query method in the MonitorClient object. A maximum of one status can be queried at one time.

1. Refer to Querying Wearable Device Information to obtain the paired device list and select the device for communications.
2. Call the getMonitorClient method in HiWear to obtain the MonitorClient object.
3. Call the query method to query the status of the specified indicator.
   • Use the MonitorItem object to query the status of the specified indicator. Currently, the following status can be queried:
     • Battery status: MONITOR_POWER_STATUS.
     • Charging status: MONITOR_CHARGE_STATUS.
     • Wearing status: MONITOR_ITEM_WEAR.
     • Device mode: MONITOR_ITEM_POWER_MODE.
   • Use the MonitorData object to return the specified device status result.
     Sample code (Querying the wearing status is used as an example.)

     // Step 2: Obtain the MonitorClient object.
     MonitorClient monitorClient = HiWear.getMonitorClient(this);
     
     // Step 3: Query the status of the specified indicator.
     if (connectedDevice != null && connectedDevice.isConnected()) {
         monitorClient.query(connectedDevice, MonitorItem.MONITOR_ITEM_WEAR)
             .addOnSuccessListener(new OnSuccessListener<MonitorData>() {
                 @Override
                 public void onSuccess(MonitorData monitorData) {
                     // Process the events related to the successful query.
                     int wearStatus = monitorData.asInt();
                     // 1: worn
                     // 2: not worn
                     if(wearStatus == 1){
                         // Process the logic related to the wearing status.
                     }
                 }
             })
             .addOnFailureListener(new OnFailureListener() {
                 @Override
                 public void onFailure(Exception e) {
                     // Process the events related to the failed query.
                 }
             });
     }

Subscribing to a Single Status

1. Refer to Querying Wearable Device Information to obtain the paired device list and select the device for communications.
2. Call the getMonitorClient method in HiWear to obtain the MonitorClient object.
3. Define the callback object monitorListener of the subscription task.
4. Call the register method to subscribe to the status changes of a specified indicator.
   • Use the MonitorItem object to subscribe to the status of the wearable device and health data. Currently, the following status can be subscribed to:
     • Device connection status: MONITOR_ITEM_CONNECTION.
     • Battery level decrease status: MONITOR_ITEM_LOW_POWER.
     • Charging status: MONITOR_CHARGE_STATUS.
     • Wearing status: MONITOR_ITEM_WEAR.
     • Heart rate alerts: MONITOR_ITEM_HEART_RATE_ALARM.
     • Device mode: MONITOR_ITEM_POWER_MODE.
   • Use the MonitorListener object to return the subscribed results for the device connection.

   Sample code (Subscribing to the wearing status is used as an example.)

   // Step 2: Obtain the MonitorClient object.
   MonitorClient monitorClient = HiWear.getMonitorClient(this);
   
   // Step 3: Define the callback object of the subscribed task.
   MonitorListener monitorListener = new MonitorListener() {
       @Override
       public void onChanged(int errorCode, MonitorItem monitorItem, MonitorData monitorData) {
           // Process the status change of the specified indicator of the wearable device.
           // Determine the wearing status of the device.
           if(MonitorItem.MONITOR_ITEM_WEAR.getName().equals(monitorItem.getName())){
               int wearStatus = monitorData.asInt();
               // 1: worn
               // 2: not worn
               if(wearStatus == 1){
                   // Process the logic related to the wearing status.
               }
           }       
       }
   };
   
   //Step 4: Subscribe to the wearing status changes.
   if (connectedDevice != null && connectedDevice.isConnected()) {
       monitorClient.register(connectedDevice, MonitorItem.MONITOR_ITEM_WEAR, monitorListener)
           .addOnSuccessListener(new OnSuccessListener<Void>() {
               @Override
               public void onSuccess(Void successVoid) {
                   // Process the events related to the successful subscription.
               }
           })
           .addOnFailureListener(new OnFailureListener() {
               @Override
               public void onFailure(Exception e) {
                   // Process the events related to the failed subscription.
               }
           });
   }

5. Call the unregister method to cancel the subscription to the status changes of the wearable device.

   monitorClient.unregister(monitorListener);

Subscribing to Multiple Statuses

1. Refer to Querying Wearable Device Information to obtain the paired device list and select the device for communications.
2. Call the getMonitorClient method in HiWear to obtain the MonitorClient object.
3. Define the callback object monitorListener of the subscription task.
4. Call the register method to subscribe to the status changes of multiple indicators.
   • Use List<MonitorItem> to subscribe to multiple status indicators of the wearable device and health data.
     • Device connection status: MONITOR_ITEM_CONNECTION.
     • Battery level decrease status: MONITOR_ITEM_LOW_POWER.
     • Wearing status: MONITOR_ITEM_WEAR.
     • Charging status: MONITOR_CHARGE_STATUS.
     • Heart rate alerts: MONITOR_ITEM_HEART_RATE_ALARM.
   • Use the MonitorListener object to return the subscribed results for the device connection.

   // Step 2: Obtain the MonitorClient object.
   MonitorClient monitorClient = HiWear.getMonitorClient(this);
   
   // Step 3: Define the callback object of the subscribed task.
   MonitorListener monitorListener = new MonitorListener() {
       @Override
       public void onChanged(int errorCode, MonitorItem monitorItem, MonitorData monitorData) {
           // Process the status change of the specified indicator of the wearable device.
           // Check whether the device is switched. If the device is switched, use the getBondedDevices method to obtain the device that has been paired with the Huawei Health app by referring to section "Querying Wearable Device Information". In addition, you can call the device.isConnected() method to obtain the device that is currently connected.
           if(MonitorItem.MONITOR_ITEM_CONNECTION.getName().equals(monitorItem.getName())){
               int connectionStatus = monitorData.asInt();
               // 2: Connected
               // 3: Disconnected
               // 4: Unable to connect
               if(connectionStatus == 3){
                   // Process the logic related to the disconnection.
               }
           }       
       }
   };
   ArrayList<MonitorItem> monitorItemList = new ArrayList<>();
   monitorItemList.add(MonitorItem.MONITOR_ITEM_CONNECTION);
   monitorItemList.add(MonitorItem.MONITOR_ITEM_LOW_POWER);
   monitorItemList.add(MonitorItem.MONITOR_ITEM_WEAR);
   monitorItemList.add(MonitorItem.MONITOR_CHARGE_STATUS);
   monitorItemList.add(MonitorItem.MONITOR_ITEM_HEART_RATE_ALARM);
   
   // Step 4: Subscribe to the status changes of multiple indicators.
   if (connectedDevice != null && connectedDevice.isConnected()) {
       monitorClient.register(connectedDevice, monitorItemList, monitorListener)
           .addOnFailureListener(new OnFailureListener() {
               @Override
               public void onFailure(Exception e) {
                   // Process the events related to the failed subscription.
               }
           })
           .addOnSuccessListener(new OnSuccessListener<Void>() {
               @Override
               public void onSuccess(Void successVoid) {
                   // Process the events related to the successful subscription.
               }
           });
   }

5. Call the unregister method to cancel the subscription to the status changes of the wearable device and health data.

   monitorClient.unregister(monitorListener);