后台消息用于内容不频繁更新的场景，不会显示通知、播放铃声或改变应用角标。终端设备接收到后台消息后，如果应用进程在前台则将消息内容传给应用；如果应用进程不在前台则缓存消息，等待应用启动后再传给应用。
说明：
终端缓存消息默认仅缓存最新的一条消息，最多缓存7天。
推送后台消息能力支持Phone、Tablet、PC/2in1。并且从18版本开始新增支持Wearable设备。从19版本开始，新增支持TV设备。
说明：
后台消息优先级较低，建议每小时不超过2条，否则消息可能会被丢弃。
后台消息推送会受设备电量状态、系统休眠、用户使用行为等影响，消息可能不会及时下发。
说明：
开发者希望在应用进程不在前台时，可根据实际情况选择消息缓存的策略。
开发者仅需缓存终端侧的最新一条消息，可不执行步骤2~步骤4。
若开发者需缓存终端侧更多消息，可参考开发步骤2~步骤4开发适配端侧数据库并开启数据代理写入，Push Kit将后台消息写入数据库中，当您的应用进程在前台时，需要自行读取数据库中的消息。
参见指导获取Push Token。
（可选）应用客户端参见指导新建一个数据库（如pushmessage.db），并严格按照如下格式创建一张数据表（如t_push_message）。
| 字段名称 | 字段类型 | 说明 |
|---|---|---|
| id | INTEGER | 自增主键。 |
| message_id | TEXT | 消息id。 |
| push_type | TEXT | 场景类型。 |
| message_action | INTEGER | 消息动作。 |
| message | TEXT | 消息内容。结构体如下：{"data": "消息体中的extraData"} |
| field1 | TEXT | 扩展字段1。 |
| field2 | TEXT | 扩展字段2。 |
| field3 | TEXT | 扩展字段3。 |
| field4 | TEXT | 扩展字段4。 |
| field5 | TEXT | 扩展字段5。 |
| create_time | INTEGER | 消息写入数据库的时间戳，单位毫秒（ms）。 |
（可选）在项目模块级目录的 src/main/resources/base/profile/ 下创建 PushMessage.json 文件，文件内容如下：
{
"path": "pushmessage/t_push_message",
"type": "rdb",
"scope": "application"
}
（可选）在项目模块级目录的 src/main/module.json5 文件添加proxyData 如下配置：
{
"module": {
"proxyData":[{
"uri": "datashareproxy://{bundleName}/PushMessage",
"requiredWritePermission": "ohos.permission.WRITE_PRIVACY_PUSH_DATA",
"metadata":{
"name": "dataProperties",
"resource": "$profile:PushMessage"
}
}]
}
}
在项目中现有的UIAbility类（以PushMessageAbility为例）的onCreate()中，调用receiveMessage()方法接收后台消息。注意，您仅能使用UIAbility接收后台消息。
// 文件路径: src/main/ets/abilities/PushMessageAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { pushService, pushCommon } from '@kit.PushKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
/**
* 此处以PushMessageAbility为例，接收后台消息内容
*/
export default class PushMessageAbility extends UIAbility {
onCreate(): void {
try {
pushService.receiveMessage('BACKGROUND', this, (data: pushCommon.PushPayload) => {
// process message，并建议对Callback进行try-catch
try {
hilog.info(0x0000, 'testTag', 'Receive background message');
} catch (e) {
let errRes: BusinessError = e as BusinessError;
hilog.error(0x0000, 'testTag', 'Failed to process data: %{public}d %{public}s', errRes.code, errRes.message);
}
});
} catch (err) {
let e: BusinessError = err as BusinessError;
hilog.error(0x0000, 'testTag', 'Failed to get background message: %{public}d %{public}s', e.code, e.message);
}
}
}
在项目工程的 src/main/module.json5文件的abilities模块的skills标签中配置actions内容为action.ohos.push.listener（有且只能有一个ability定义该action，若同时添加uris参数，则uris内容需为空）。
"abilities": [
{
"name": "PushMessageAbility",
"srcEntry": "./ets/abilities/PushMessageAbility.ets",
"launchType": "singleton",
"startWindowIcon": "$media:startIcon",
"startWindowBackground": "$color:start_window_background",
"exported": false,
"skills": [
// 保持现有skill对象不变
{
"actions": [
"com.app.action"
]
},
// 新增一个独立的skill对象，配置actions参数
{
"actions": [
"action.ohos.push.listener"
]
}
]
}
]
应用服务端调用REST API推送后台消息，消息详情可参见场景化消息API接口功能介绍，请求示例如下：
// Request URL
POST "https://oh-push-api.getui.com/v3/[appId]/messages:send"
// Request Header
Content-Type: application/json
Authorization: Bearer eyJ0eX******IUzI1NiJ9.eyJpc******YzNTZ9.j6y1NGM******NncAeLE
push-type: 6
// Request Body
{
"payload": {
"extraData": "携带的额外数据",
"proxyData": "ENABLE"
},
"target": {
"token": ["o39qtoP7Nd6s*******2d4d5636"]
}
}
当设备中的应用进程在前台时会直接拉起应用并将数据传递，您可以在receiveMessage()方法中获取消息数据。
当应用进程不在前台且proxyData为“ENABLE”时，推送服务将后台消息写入到数据库中，建议您在应用进程在前台时将数据库中数据迁移到您业务数据库中（避免数据库大小无限制增长）。当应用进程不在前台且无proxyData时则为缓存消息（发送多条消息时仅缓存最新的一条），等下次应用进程在前台时调用getToken()接口，Push Kit将重新发送缓存消息，您可以在receiveMessage()方法获取消息数据。
