目录

Assigning Permissions in the Manifest File

Before calling the Bluetooth car stereo awareness capability, assign required permissions in the manifest file.

  1. <!-- Bluetooth permission -->
  2. <uses-permission android:name="android.permission.BLUETOOTH" />

Importing API Classes

To use the Bluetooth car stereo awareness capability, you need to import the public capability classes of HUAWEI Awareness Kit, and also the Bluetooth car stereo-related classes.

  1. import com.huawei.hmf.tasks.OnFailureListener;
  2. import com.huawei.hmf.tasks.OnSuccessListener;
  3. import com.huawei.hms.kit.awareness.Awareness;
  4. // Import the Bluetooth car stereo capture-related classes.
  5. import com.huawei.hms.kit.awareness.capture.BluetoothStatusResponse;
  6. import com.huawei.hms.kit.awareness.status.BluetoothStatus;
  7. // Import the Bluetooth car stereo barrier-related classes.
  8. import com.huawei.hms.kit.awareness.barrier.AwarenessBarrier;
  9. import com.huawei.hms.kit.awareness.barrier.BarrierStatus;
  10. import com.huawei.hms.kit.awareness.barrier.BluetoothBarrier;
  11. import com.huawei.hms.kit.awareness.barrier.BarrierUpdateRequest;

Developing Capabilities

Developing capture capabilities

1. Obtain the Capture Client object of HUAWEI Awareness Kit.

2. Call the Bluetooth car stereo status query capability API through the Capture Client object to obtain the user's context.

3. Enable your app to listen for the result returned by HUAWEI Awareness Kit for further processing.

  1. int deviceType = 0; // Value 0 indicates a Bluetooth car stereo.
  2. Awareness.getCaptureClient(this).getBluetoothStatus(deviceType)
  3.         .addOnSuccessListener(new OnSuccessListener<BluetoothStatusResponse>() {
  4.             @Override
  5.             public void onSuccess(BluetoothStatusResponse bluetoothStatusResponse) {
  6.                 BluetoothStatus bluetoothStatus = bluetoothStatusResponse.getBluetoothStatus();
  7.                 int status = bluetoothStatus.getStatus();
  8.                 String stateStr = "The Bluetooth car stereo is " +
  9.                         (status == BluetoothStatus.CONNECTED ? "connected" : "disconnected");
  10.                 Log.i(TAG, stateStr);
  11.             }
  12.         })
  13.         .addOnFailureListener(new OnFailureListener() {
  14.             @Override
  15.             public void onFailure(Exception e) {
  16.                 Log.e(TAG, "get bluetooth status failed", e);
  17.             }
  18.         });

Developing barrier capabilities

The following example illustrates how to develop a barrier triggered by the connecting condition. That is, the barrier will be triggered when the Bluetooth car stereo is connected.

1. Define the barrier.

  1. final int deviceType = 0; // Value 0 indicates a Bluetooth car stereo.
  2. AwarenessBarrier connectingBarrier = BluetoothBarrier.connecting(deviceType);

2. Define PendingIntent that will be triggered upon a barrier status change, for example, to send a broadcast, and create a broadcast receiver to receive the broadcast.

  1. final String BARRIER_RECEIVER_ACTION = getApplication().getPackageName() + "BLUETOOTH_BARRIER_RECEIVER_ACTION";
  2. Intent intent = new Intent(BARRIER_RECEIVER_ACTION);
  3. PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 1, intent, PendingIntent.FLAG_UPDATE_CURRENT);
  4. BluetoothBarrierReceiver barrierReceiver = new BluetoothBarrierReceiver();
  5. registerReceiver(barrierReceiver, new IntentFilter(BARRIER_RECEIVER_ACTION));

3. Add the barrier.

  1. String bluetoothBarrierLabel = "bluetooth connecting barrier";
  2. BarrierUpdateRequest.Builder builder = new BarrierUpdateRequest.Builder();
  3. BarrierUpdateRequest request = builder.addBarrier(bluetoothBarrierLabel, connectingBarrier,pendingIntent).build();
  4. Awareness.getBarrierClient(context).updateBarriers(request)
  5.         .addOnSuccessListener(new OnSuccessListener<Void>() {
  6.             @Override
  7.             public void onSuccess(Void aVoid) {
  8.                 Toast.makeText(getApplicationContext(), "add barrier success", Toast.LENGTH_SHORT).show();
  9.             }
  10.         })
  11.         .addOnFailureListener(new OnFailureListener() {
  12.             @Override
  13.             public void onFailure(Exception e) {
  14.                 Toast.makeText(getApplicationContext(), "add barrier failed", Toast.LENGTH_SHORT).show();
  15.                 Log.e(TAG, "add barrier failed", e);
  16.             }
  17.         });

4. Define the broadcast receiver to listen for the barrier event for further processing.

  1. class BluetoothBarrierReceiver extends BroadcastReceiver {
  2.     @Override
  3.     public void onReceive(Context context, Intent intent) {
  4.         BarrierStatus barrierStatus = BarrierStatus.extract(intent);
  5.         String label = barrierStatus.getBarrierLabel();
  6.         switch(barrierStatus.getPresentStatus()) {
  7.             case BarrierStatus.TRUE:
  8.                 Log.i(TAG, label + " status:true");
  9.                 break;
  10.             case BarrierStatus.FALSE:
  11.                 Log.i(TAG, label + " status:false");
  12.                 break;
  13.             case BarrierStatus.UNKNOWN:
  14.                 Log.i(TAG, label + " status:unknown");
  15.                 break;
  16.         }
  17.     }
  18. }