在Manifest指定权限
在调用情景感知能力时,开发者需要先在Manifest中指定相应的权限。使用不同情景感知能力需指定不同的权限,具体所需权限请参阅《开发指南》。例如,使用耳机状态感知能力,需要开启设备的蓝牙功能,需要在Manifest中申请蓝牙权限:
导入接口类
在调用不同的情景感知能力时,开发者需要导入相应的能力接口类。不同能力所需的类的路径和类名不同,具体请参阅《API参考》。例如,使用耳机状态感知能力,除需要导入情景感知服务的公共能力类外,还需要导入耳机状态相关的类。
import com.huawei.hmf.tasks.OnFailureListener;
import com.huawei.hmf.tasks.OnSuccessListener;
import com.huawei.hms.kit.awareness.Awareness;
// 导入耳机快照相关类
import com.huawei.hms.kit.awareness.capture.HeadsetStatusResponse;
import com.huawei.hms.kit.awareness.status.HeadsetStatus;
// 导入耳机围栏相关类
import com.huawei.hms.kit.awareness.barrier.AwarenessBarrier;
import com.huawei.hms.kit.awareness.barrier.BarrierStatus;
import com.huawei.hms.kit.awareness.barrier.HeadsetBarrier;
import com.huawei.hms.kit.awareness.barrier.BarrierUpdateRequest;
Capture能力开发
获取Awareness Kit的"CaptureClient"。
通过"Capture Client"调用耳机状态查询能力接口查询情景状态。
监听情景感知服务结果返回,进行应用的业务处理。
Java示例代码:
Awareness.getCaptureClient(this).getHeadsetStatus()
.addOnSuccessListener(new OnSuccessListener() {
@Override
public void onSuccess(HeadsetStatusResponse headsetStatusResponse) {
HeadsetStatus headsetStatus = headsetStatusResponse.getHeadsetStatus();
int status = headsetStatus.getStatus();
String stateStr = "Headsets are " +
(status == HeadsetStatus.CONNECTED ? "connected" : "disconnected");
Log.i(TAG, stateStr);
}
})
.addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Log.e(TAG, "get Headsets Capture failed", e);
}
});
Kotlin示例代码:
Awareness.getCaptureClient(this).headsetStatus
.addOnSuccessListener { headsetStatusResponse: HeadsetStatusResponse ->
val headsetStatus = headsetStatusResponse.headsetStatus
val status = headsetStatus.status
val stateStr = "Headsets are " +if (status == HeadsetStatus.CONNECTED) "connected" else "disconnected"
Log.i(TAG, stateStr)
}
.addOnFailureListener { e: Exception? ->
Log.e(TAG, "get Headsets Capture failed", e)
}
Barrier能力开发
以下以开发耳机"Connecting"的Barrier为例(耳机插入后触发Barrier)。
1. 定义Barrier。
Java示例代码:
AwarenessBarrier headsetBarrier = HeadsetBarrier.connecting();
Kotlin示例代码:
var headsetBarrier : AwarenessBarrier = HeadsetBarrier.connecting()
2. 定义Barrier状态改变时触发的"PendingIntent",本示例中为发送一个广播,同时新建一个广播接收器用来接收这个广播。
Java示例代码:
final String BARRIER_RECEIVER_ACTION = getApplication().getPackageName() + "HEADSET_BARRIER_RECEIVER_ACTION";
Intent intent = new Intent(BARRIER_RECEIVER_ACTION);
PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 1, intent, PendingIntent.FLAG_UPDATE_CURRENT);
HeadsetBarrierReceiver barrierReceiver = new HeadsetBarrierReceiver();
registerReceiver(barrierReceiver, new IntentFilter(BARRIER_RECEIVER_ACTION));
Kotlin示例代码:
val BARRIER_RECEIVER_ACTION = application.packageName + "HEADSET_BARRIER_RECEIVER_ACTION"
val intent = Intent(BARRIER_RECEIVER_ACTION)
val pendingIntent = PendingIntent.getBroadcast(this, 1, intent, PendingIntent.FLAG_UPDATE_CURRENT)
val barrierReceiver = HeadsetBarrierReceiver()
registerReceiver(barrierReceiver, IntentFilter(BARRIER_RECEIVER_ACTION))
3. 定义Barrier对应的标签Label,然后添加Barrier。
Java示例代码:
String headsetBarrierLabel = "headset connecting barrier";
BarrierUpdateRequest.Builder builder = new BarrierUpdateRequest.Builder();
BarrierUpdateRequest request = builder.addBarrier(headsetBarrierLabel, headsetBarrier,pendingIntent).build();
Awareness.getBarrierClient(context).updateBarriers(request)
.addOnSuccessListener(new OnSuccessListener() {
@Override
public void onSuccess(Void aVoid) {
Toast.makeText(getApplicationContext(), "add barrier success", Toast.LENGTH_SHORT).show();
}
})
.addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Toast.makeText(getApplicationContext(), "add barrier failed", Toast.LENGTH_SHORT).show();
Log.e(TAG, "add barrier failed", e);
}
});
Kotlin示例代码:
val headsetBarrierLabel = "headset connecting barrier"
val builder = BarrierUpdateRequest.Builder()
val request = builder.addBarrier(headsetBarrierLabel, headsetBarrier, pendingIntent).build()
Awareness.getBarrierClient(context).updateBarriers(request)
.addOnSuccessListener { Toast.makeText(applicationContext, "add barrier success", Toast.LENGTH_SHORT).show()
}
.addOnFailureListener { e ->
Toast.makeText(applicationContext, "add barrier failed", Toast.LENGTH_SHORT).show()
Log.e(TAG, "add barrier failed", e)
}
4. 定义广播接收器,用于监听Barrier事件,收到事件后进行应用的业务处理。
Java示例代码:
class HeadsetBarrierReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
BarrierStatus barrierStatus = BarrierStatus.extract(intent);
String label = barrierStatus.getBarrierLabel();
switch(barrierStatus.getPresentStatus()) {
case BarrierStatus.TRUE:
Log.i(TAG, label + " status:true");
break;
case BarrierStatus.FALSE:
Log.i(TAG, label + " status:false");
break;
case BarrierStatus.UNKNOWN:
Log.i(TAG, label + " status:unknown");
break;
}
}
}
Kotlin示例代码:
internal inner class HeadsetBarrierReceiver : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
val barrierStatus = BarrierStatus.extract(intent)
val label = barrierStatus.barrierLabel
when (barrierStatus.presentStatus) {
BarrierStatus.TRUE -> Log.i(TAG, "$label status:true")
BarrierStatus.FALSE -> Log.i(TAG, "$label status:false")
BarrierStatus.UNKNOWN -> Log.i(TAG, "$label status:unknown")
}
}
}