設置通知聲音
設置推送通知聲音文件路徑。注意Android 8.0以上需要使用NotificationChannel配置聲音。
若不調用本接口,默認獲取資源ID為
R.raw.alicloud_notification_sound
的資源文件。若沒有獲取到指定聲音文件,取設備設置的消息聲音。
setNotificationSoundFilePath
接口定義
void setNotificationSoundFilePath(String filePath)
所屬類
CloudPushService
參數說明
參數 | 類型 | 是否必填 | 說明 |
filePath | String | 是 | Uri可以解析的字符串 |
設置通知欄圖標
設置推送通知欄圖標資源Bitmap。
若不調用本接口,默認獲取ID為
R.drawable.alicloud_notification_largeicon
的資源文件。若沒有獲取到指定圖標文件,取App啟動圖標。
setNotificationLargeIcon
接口定義
void setNotificationLargeIcon(Bitmap icon)
所屬類
CloudPushService
參數說明
參數 | 類型 | 是否必填 | 說明 |
icon | Bitmap | 是 | 圖標資源Bitmap。 |
設置狀態欄圖標
設置推送通知狀態欄圖標資源id。
若不調用本接口,默認獲取
R.drawable.alicloud_notification_smallicon
的資源文件。若沒有獲取到指定資源文件id,取App啟動圖標。
setNotificationSmallIcon
接口定義
void setNotificationSmallIcon(int iconId)
所屬類
CloudPushService
參數說明
參數 | 類型 | 是否必填 | 說明 |
iconId | int | 是 | 圖標資源id。 |
設置免打擾時段
設置免打擾時間段,過濾所有通知與消息。
免打擾時段僅支持設置一次,多次調用以最后一次調用設置時段為準。
SDK版本V2.3.5以下,設置免打擾時間段為00:00-00:00,可取消免打擾功能。
全天免打擾可以設置為“00:00-23:59”。
免打擾時段設置對小米輔助彈窗通知無效。
setDoNotDisturb
接口定義
void setDoNotDisturb(int startHour, int startMinute, int endHour, int endMinute, CommonCallback callback)
所屬類
CloudPushService
參數說明
參數 | 類型 | 是否必須 | 說明 |
startHour | int | 是 | 免打擾的起始時間(小時),24小時制,取值范圍:0-23。 |
starMinute | int | 是 | 免打擾起始時間(分鐘),取值范圍:0-59。 |
endHour | int | 是 | 免打擾的結束時間(小時),24小時制,取值范圍:0-23。 |
endMinute | int | 是 | 免打擾結束時間(分鐘),取值范圍:0-59。 |
callback | int | 是 | 設置免打擾時間段的回調類,設置成功后會回調onSuccess,失敗以后會回調onFailed。 |
關閉免打擾功能
關閉免打擾功能。
免打擾功能是默認關閉的。
沒有對應的開發免打擾功能接口,調用設置免打擾功能時間段功能后自動打開免打擾功能。
SDK版本V2.3.5及以上版本支持。
closeDoNotDisturbMode
接口定義
void closeDoNotDisturbMode()
所屬類
CloudPushService
刪除所有通知
刪除推送SDK創建的所有通知。廠商通道的通知無法控制刪除。
若需要實現精準刪除特性通知,可在onNotification回調中獲取通知id,自行刪除。
SDK版本V2.3.7及以上版本支持。
clearNotifications
接口定義
void clearNotifications()
所屬類
CloudPushService
設置大圖標下載監控回調
設置大圖標和大圖下載失敗監控回調,感知大圖標和大圖下載失敗的狀態和失敗原因。
SDK版本v3.8.2及以上支持
setLargeIconDownloadListener
接口定義
void setLargeIconDownloadListener(OnLargeIconDownloadListener listener)
所屬類
CloudPushService
參數說明
參數 | 類型 | 是否必須 | 說明 |
listener | OnLargeIconDownloadListener | 是 | 下載回調。 |
設置通知折疊展示
設置多條通知折疊展示,默認不折疊。
SDK版本v3.8.2及以上支持
setNotificationShowInGroup
接口定義
void setNotificationShowInGroup(boolean inGroup)
所屬類
CloudPushService
參數說明
參數 | 類型 | 是否必須 | 說明 |
inGroup | boolean | 是 |
|
應用內通道控制接口
SDK版本V3.7.4及以上版本支持。
此類接口用于一些需要連接強控制的場景,手機場景不需要
控制接口包括判斷應用內通道是否連接、重連、重置、監聽連接狀態等接口。
isConnected
判斷應用內通道是否連接。
接口定義
boolean isConnected()
所屬類
PushControlService
返回說明
類型 | 說明 |
boolean |
|
setConnectionChangeListener
監聽連接狀態接口和判斷應用內通道是否連接接口主要用于輔助業務方判斷連接的狀態。
接口定義
void setConnectionChangeListener(ConnectionChangeListener listener)
所屬類
PushControlService
參數說明
參數 | 類型 | 是否必須 | 說明 |
listener | ConnectionChangeListener | 是 | 監聽回調接口。 |
代碼示例
PushServiceFactory.getPushControlService()
.setConnectionChangeListener(object : ConnectionChangeListener {
override fun onConnect() {}
override fun onDisconnect(code: String, msg: String) {}
})
PushServiceFactory.getPushControlService().setConnectionChangeListener(new PushControlService.ConnectionChangeListener() {
@Override
public void onConnect() {
}
@Override
public void onDisconnect(String code, String msg) {
}
});
reconnect
重連接口用于在業務方發現連接斷開一定時間還未重連上時,主動嘗試重連。
接口定義
void reconnect()
所屬類
PushControlService
reset
重置接口用于重置SDK內部的初始化狀態,用于在主動重連后,連接也不會恢復時,重置SDK內部狀態,然后調用SDK注冊接口,重新注冊推送通道。
接口定義
void reset()
所屬類
PushControlService