【情景感知服務(wù)】讓你的音樂APP更智能更懂用戶（增加demo源代碼）

場景

情景感知服務(wù)能帶來什么

作為音樂發(fā)燒友，閑下來的時候總想打開App还绘，享受沉浸在音樂中的放松。然而栖袋，App推薦的歌單經(jīng)常沒法滿足我的需要拍顷，如果App能根據(jù)我當前的情景狀態(tài)，推送給我的歌曲恰好就是我當前最想聽的塘幅，那該多好啊~

什么是情景感知服務(wù)昔案？

情景感知服務(wù)（Awareness
Kit）能感知用戶當前的時間、地理位置电媳、活動狀態(tài)踏揣、耳機狀態(tài)、天氣狀況匾乓、環(huán)境光捞稿、車載連接狀態(tài)、信標連接狀態(tài)等情景钝尸，并通過能常駐后臺運行的圍欄能力向APP進行提醒括享，使APP能第一時間給用戶提供精準和貼心的服務(wù)。上述情景感知能力還在不斷擴充中珍促，而且您可以自由組合這些感知能力铃辖，構(gòu)建組合圍欄，從而讓APP的服務(wù)能力更加智能猪叙，更加精準娇斩。

在情景感知服務(wù)的支持下，App能給用戶帶來如下體驗

l 每次連接上耳機（有線耳機穴翩、藍牙耳機）犬第，手機通知欄會彈出音樂App通知，提示用戶時候是否要啟動音樂播放芒帕，或者是否要自動播放音樂

l 點擊通知歉嗓，可以打開音樂APP，并展示用戶當前情境下最恰當?shù)母鑶?/p>
l 跑步開始背蟆，推薦節(jié)奏輕快歌單鉴分；跑步結(jié)束哮幢，推薦節(jié)奏緩場歌單

l 清晨起床，連接耳機志珍，來點清新音樂橙垢；夜深人靜，連接耳機伦糯，讓靜心的音樂讓我舒緩

l 發(fā)動汽車柜某，手機連接藍牙車載，音樂App自動切換成車載模式敛纲，并主動詢問是否播放各場景的行車音樂（白天喂击、夜晚、雨天淤翔、晴天惭等，推薦各不同）

l 不同的節(jié)日，應(yīng)該有特別的節(jié)日音樂

同時办铡，用戶還可以通過各種感知能力的組合圍欄，設(shè)置排除場景琳要，避免給用戶過多打擾

情景感知服務(wù)的優(yōu)勢

無需用戶提前開啟App寡具，用戶進入地理圍欄范圍后，即可后臺激活A(yù)pp稚补，觸發(fā)通知童叠。

無懼App進程被系統(tǒng)殺死，通過圍欄服務(wù)课幕，依然可接受到通知厦坛。

點擊通知，即可前臺激活A(yù)PP乍惊，點擊直接跳轉(zhuǎn)App推薦界面杜秸。

通過組合圍欄實現(xiàn)精準推送；也可避免在用戶不需要的場景提供無效通知润绎，避免頻繁打擾撬碟。

開發(fā)前準備

Awareness Kit集成需要有如下3個關(guān)鍵步驟，可以參考華為開發(fā)者聯(lián)盟的文檔

```
 AppGallery Connect配置
```
```
集成HMS Awareness SDK
```
```
配置混淆腳本
```

https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/awareness-preparation

代碼開發(fā)關(guān)鍵步驟

1.創(chuàng)建耳機圍欄

//創(chuàng)建一個感知耳機連接的圍欄莉撇，當耳機處于連接狀態(tài)時呢蛤，此圍欄的狀態(tài)為true
AwarenessBarrier headsetBarrier = HeadsetBarrier.keeping(HeadsetStatus.CONNECTED);
 
//創(chuàng)建一個PendingIntent，當圍欄狀態(tài)改變的時候棍郎，會觸發(fā)該PendingIntent其障，這里以發(fā)送廣播為例
PendingIntent pendingIntent = PendingIntent.getBroadcast(context,0,intent,PendingIntent.FLAG_UPDATE_CURRENT);
 
//創(chuàng)建圍欄的標簽，后續(xù)可以通過標簽查詢或者刪除對應(yīng)圍欄
String headsetBarrierLabel = "headset keeping connected label";

2.注冊圍欄

//把剛剛創(chuàng)建好的耳機圍欄和它對應(yīng)的label涂佃，pendingIntent注冊給Awareness kit
Awareness.getBarrierClient(context).updateBarriers(new BarrierUpdateRequest.Builder()
        .addBarrier(headsetBarrierLabel,headsetBarrier,pendingIntent).build())
        .addOnSuccessListener(aVoid -> {
            //注冊圍欄成功
            Log.i(TAG,"add barrier success");
        })
        .addOnFailureListener(e -> {
            //注冊圍欄失敗
            Log.e(TAG,"add barrier failed");
            e.printStackTrace();
        });

3.創(chuàng)建廣播接收器監(jiān)聽圍欄事件

//本示例中我們耳機圍欄的PendingIntent設(shè)置的是發(fā)送廣播励翼，所以需要定義對應(yīng)的廣播接收器來監(jiān)聽圍欄的狀態(tài)
public final class HeadsetBarrierReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        //圍欄的信息通過intent傳遞過來蜈敢，我們通過Barrier.extract方法將其解析出來
        BarrierStatus barrierState = BarrierStatus.extract(intent);
        //通過BarrierStatus獲取label和圍欄的當前狀態(tài)
        String label = barrierState.getBarrierLabel();
        int status = barrierState.getPresentStatus();
        if (status == BarrierStatus.TRUE && label.equals(headsetBarrierLabel)) {
            //當圍欄狀態(tài)為true時，代表耳機處于連接狀態(tài)抚笔，這時就可以在通知欄推送相關(guān)消息
             //send Notification....
        }
    }
}

4.通過Awareness快照接口獲取當前情景狀態(tài)

在用戶點擊通知打開app后扶认，可以通過Awareness各個能力的快照接口來獲取用戶當前的情景狀態(tài)以推薦不同歌單。

例如獲取時間情景狀態(tài)：

Awareness.getCaptureClient(context).getTimeCategories()
        .addOnSuccessListener(timeIntervalsResponse -> {
            TimeCategories categories = timeIntervalsResponse.getTimeCategories();
            if (categories.isTimeCategory(TimeBarrier.TIME_CATEGORY_HOLIDAY)) {
                //當天是節(jié)假日殊橙，可推薦節(jié)假日歌單
            }
             if (categories.isTimeCategory(TimeBarrier.TIME_CATEGORY_WEEKEND)) {
                //當天是周末辐宾，可推薦周末歌單
            }
             if (categories.isTimeCategory(TimeBarrier.TIME_CATEGORY_NIGHT)) {
                //當前是深夜，可推薦深夜歌單
            }
        })
        .addOnFailureListener(e -> {
             //獲取時間信息失敗
            Log.e(TAG, "get Time Categories failed");
            e.printStackTrace();
        });

獲取用戶當前的活動狀態(tài)以推薦歌單：

Awareness.getCaptureClient(context).getBehavior()
        .addOnSuccessListener(behaviorResponse -> {
            BehaviorStatus behaviorStatus = behaviorResponse.getBehaviorStatus();
            DetectedBehavior mostLikelyBehavior = behaviorStatus.getMostLikelyBehavior();
            String str = "Most likely behavior is " + mostLikelyBehavior.getType();
        })
        .addOnFailureListener(e -> {
            //獲取活動狀態(tài)失敗
            Log.e(TAG, "Failed to get the behavior.", e);
        });

獲取當前是否是連接車載藍牙：

int deviceType = 0; // 0 代表獲取的設(shè)備類型為車載藍牙
Awareness.getCaptureClient(this).getBluetoothStatus(deviceType)
        .addOnSuccessListener(bluetoothStatusResponse -> {
            BluetoothStatus bluetoothStatus = bluetoothStatusResponse.getBluetoothStatus();
            int status = bluetoothStatus.getStatus();
            if (status == BluetoothStatus.CONNECTED) {
                //當前是連接車載藍牙膨蛮，可將app切換為車載模式
            }
        })
        .addOnFailureListener(e -> {
             //獲取車載藍牙狀態(tài)失敗
            Log.e(TAG, "Failed to get Bluetooth status.", e);
        });

Demo效果

為了便于開發(fā)者更好的理解此場景叠纹，我們也做了一個demo app，展示情景感知給音樂app帶來的更好體驗敞葛，請移步Github
https://github.com/Bun-Cheung/Awa-Music

開發(fā)者交流
更多建議和需求誉察，歡迎聯(lián)系 awareness@huawei.com