898      魔獸

推送使用場景__最佳實踐_移動推送-阿裏雲

• 按設備號deviceId推送
• 按賬號account推送
• 按別名alias推送
• 按標簽tag推送
• 通知的各種應用場景
  • 打開應用
  • 打開指定activity
  • 打開指定網頁
  • 自定義 key/value 說明
• 查看設備狀態
• 查看推送效果

1、按設備號推送

• deviceId是設備在推送係統的唯一標識，剛接入推送時，一般驗證推送效果會采用這種推送方式，deviceId的說明和獲取方式可參考deviceId、deviceToken的概念和區別；

• 在控製台推送的“高級設置”選擇 “指定終端”，或者在OpenAPI中按照device推送：setTarget(“device”)。

2、按賬戶推送

• 賬戶account的設定可參考SDK API文檔中接口的相關描述；
• 注： 按account推送的時候，綁定該account的手機都會收到推送。如有賬號之間互斥登陸需要自己的業務來保證。
• 在控製台推送的“高級設置”選擇 “指定賬號”，或者在OpenAPI中按照account推送：setTarget(“account”)。
• 注：如需要解綁賬號，調用unbindAccount方法。

3、按別名推送

• alias是給設備添加的別名，相比於account，別名綁定更加靈活，同一設備最多添加128個別名，單個別名長度最大為128字節；
• 具體接口描述和調用方式參考SDK API文檔；
• 別名綁定後，在OpenAPI中按alias推送:setTarget(“alias”)，調用setTargetValue()指定別名即可；
• 調用removeAlias()接口可以刪除設備的指定別名或全部別名。

4、按標簽推送

• tag是給設備添加的標簽，可以是任意您的業務需要的，支持向【設備】【賬號】【別名】綁定標簽，係統最大支持128個標簽。
• 具體接口描述和調用方式參考SDK API文檔；
• 綁定tag後，在Open API中按tag推送：setTarget(“tag”)，調用setTargetValue()指定標簽名即可。
• 注：使用unbindTag接口可以解綁添加的標簽，解綁標簽不同於刪除，目前不支持標簽刪除功能。

5、通知的各種應用場景

• 打開應用
• 打開指定activity
• 打開指定網頁
• 自定義 key/value 說明

5.1 打開應用

• 點擊通知欄通知會打開定的App，如果App本來處在前台，不發生跳轉動作；
• OpenAPI設置如下：

  pushRequest.setAndroidOpenType("1"); // 點擊通知後動作,1:打開應用 2: 打開應用Activity 3:打開 url

5.2 打開指定activity

• 點擊通知欄通知會跳轉到對應的App的指定Activity中；
• Activity名的設置為”包名 + Activity名”的格式，OpenAPI設置如下：

  pushRequest.setAndroidOpenType("2"); // 點擊通知後動作,1:打開應用 2: 打開應用Activity 3:打開 url
  pushRequest.setAndroidActivity("com.alibaba.cloudpushdemo.bizactivity.DeviceActivity"); // 設定通知打開的activity

5.3 打開指定網頁

• 點擊通知欄通知會調用手機係統的瀏覽器並打開指定的URL。
• OpenAPI設置如下：

pushRequest.setAndroidOpenType("3"); // 點擊通知後動作,1:打開應用 2: 打開應用Activity 3:打開 url
pushRequest.setAndroidOpenUrl("https://www.aliyun.com"); // Android收到推送後打開對應的url，僅當androidOpenType=3有效

5.4 自定義 key/value 說明

• 以Android為例，通過OpenAPI發送通知的時候，設置androidExtParameters

pushRequest.setAndroidExtParameters("{"key":"value-muting"}");//設定android類型設備通知的擴展屬性

• 在Android端重寫通知相關的方法，獲取extraMap參數

import com.alibaba.sdk.android.push.MessageReceiver;
protected void onNotification(Context context, String title, String summary, Map<String, String> extraMap) {}
protected void onNotificationOpened(Context context, String title, String summary, String extraMap) {}

02-29 15:33:11.412 32577-32577/com.alibaba.push2 E/MyMessageReceiver: onNotificationOpened, title: pop title, summary: pop body.., extraMap:{"key":"value-muting"}