【FAQ】HarmonyOS SDK 閉源開放能力 —Push Kit（4）

HarmonyOS_SDK發表於2024-10-29

1.問題描述：

目前華為推送API使用的是v2或者v1版本，請問目前最新的鴻蒙next使用v3版本是否相容v2或者v1，反過來將v2或者v1的api可以推送鴻蒙next的裝置嗎？

解決方案：

v3介面相容向非HarmonyOS NEXT裝置推送，老版本介面不相容向HarmonyOS NEXT裝置推送。

2.問題描述：

獲取Push Token報錯 Get push token catch error: 1000900010 Illegal application identity.

解決方案：

檢查以下配置項是否正確：

1、確認AppGallery Connect上配置的應用簽名證書指紋與應用實際證書是否一致， API 9以上應用需要選擇“新增公鑰指紋 (HarmonyOS API 9及以上)”的方式配置。
https://developer.huawei.com/consumer/cn/doc/app/agc-help-sig...

2、在專案模組級別下的src/main/module.json5（例如entry/src/main/module.json5）中配置client_id，需要使用專案設定->常規頁面->應用->OAuth 2.0客戶端ID（憑據）中的Client ID。
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides...

注意：配置證書指紋後生效需要一定時間，建議30-60分鐘後重試。

3.問題描述：

  1. push-type=0的普通訊息如果要帶圖片，是否要先調圖片風控介面？
  2. 圖片風控介面返回的expireTime最長截止時間是多久？

解決方案：

1、目前傳送 push-type：0 通知訊息未限制必須圖片風控，圖片符合文件說明規格即可。
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides...

2、expireTime 一般為7天。

4.問題描述：

應用在AppGallery Connect申請了除錯證書、開啟了推送服務，app專案中配置了除錯證書籤名，應用也配置了client_id，但是獲取token失敗，報錯資訊 get token fail:, {error.name:Error, error.message:Illegal application identity.} ,json:{"code":1000900010}}

解決方案：

1，在API管理中，開啟相關服務的API。會有一定的延遲，一般有10分鐘左右。

2, 應用在AppGallery Connect上建立時未選擇HarmonyOS應用型別。

3，module.json5檔案中metadata節點下clientid寫正確。需要直接寫client_id的資訊，不能透過$符引用資原始檔中的值，當前無法解析這種引用方式。

4，簽名證書使用這個選項中的 配置方式 “選擇SHA256公鑰指紋‘’。

a、生成配置指紋： https://developer.huawei.com/consumer/cn/doc/harmonyos-guides...

b、配置證書指紋： https://developer.huawei.com/consumer/cn/doc/app/agc-help-sig... 如果以上方式無法解決，請透過如下方式抓取日誌以便分析，聯絡方式https://developer.huawei.com/consumer/cn/support/feedback/#/：

1. 執行：hdc hilog > xxxx.log

2. 復現場景

3. 停止指令碼執行

4. 在目錄下獲取日誌資訊

5.問題描述：

推送VoIP呼叫訊息和音影片介面是都內建的嗎?開發者是否只需配置一個UI其他方面不用考慮？

解決方案：

1、音影片頁面應用需要自定義，文件示例程式碼提供的頁面效果僅供開發參考，不代表最終效果。

2、VoIP呼叫訊息負責拉起應用的程序，在程序內完成通話狀態上報彈出呼叫橫幅通知，監聽通話狀態回撥，被呼叫頁面載入等操作。鈴聲、震動、音影片效果等需要開發者自行適配完成。
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides...

6.問題描述：

通知擴充套件訊息體現：

push-type: 2
// Request Body
{ 
  "payload": { 
    "extraData": "通知擴充套件場景攜帶的額外資料", 
    "notification": { 
      "category": "EXPRESS",  
      "title": "通知標題", 
      "body": "通知內容", 
      "clickAction": { 
        "actionType": 0 
      } 
    }
  }
}

notification這部分資訊是否會以通知方式展示？如果展示，那麼和onReceiveMessage要返回的RemoteNotificationContent有什麼區別？
extraData這部分資訊是不是透過onReceiveMessage方式傳遞？

解決方案：

  1. notification-----這部分資訊是否會以通知方式展示？

會在RemoteNotificationContent中return中展示

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides...

  1. extraData------這部分資訊是不是透過onReceiveMessage方式傳遞？

擴充套件訊息是可以透過onReceiveMessage 獲取。

https://developer.huawei.com/consumer/cn/doc/harmonyos-refere...

  1. onReceiveMessage如果返回空是什麼結果？

有可能是沒有擴充套件訊息的許可權

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides...

相關文章