MDM（Mobile Device Management）消息用于设备管理场景，支持向终端设备下发管理指令。MDM应用在后台时仍能接收MDM消息，可以确保设备管理员或企业IT部门在任何情况下都能及时下发/收到携带指令的MDM消息，比如设备异常、安全策略更新或远程操作指令。

约束与限制

推送MDM消息能力支持Phone、Tablet、PC/2in1。

开通权益

推送MDM消息需要申请推送MDM消息权益，请参见申请推送MDM消息权益。

频控规则

调测阶段，每个项目每日全网最多可推送1000条测试消息。发送测试消息需设置testMessage为true。

正式发布阶段，单设备单应用下每日推送消息总条数受设备消息频控限制，系统会根据使用场景和流量进行管控，不合理的使用场景系统会进行频控。

开发步骤

参见指导获取Push Token，使用token推送MDM消息。

在项目中现有的UIAbility类（以PushMessageAbility为例）的onCreate中，调用receiveMessage方法接收MDM消息。MDM消息与后台消息共用同一个回调入口，类型参数均为'BACKGROUND'；当data.type为'MDM'时，该消息即为MDM消息。仅能使用UIAbility接收MDM消息。

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { pushCommon, pushService } from '@kit.PushKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// ...

const DOMAIN = 0x0000;

export default class PushMessageAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  // ...
    try {
      pushService.receiveMessage('BACKGROUND', this, (data: pushCommon.PushPayload) => {
        // process message
        try {
          if (data.type === 'MDM') {
            hilog.info(DOMAIN, 'testTag', 'Receive MDM message : %{public}s', JSON.stringify(data));
            // 处理MDM消息
            // ...
          }
        } catch (e) {
          let errRes: BusinessError = e as BusinessError;
          hilog.error(DOMAIN, 'testTag', 'Failed to process data: %{public}d %{public}s', errRes.code, errRes.message);
        }
      });
    } catch (err) {
      let e: BusinessError = err as BusinessError;
      hilog.error(DOMAIN, '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内容需为空）。

{
  "name": "PushMessageAbility",
  "srcEntry": "./ets/abilities/PushMessageAbility.ets",
  "description": "$string:PushMessageAbility_desc",
  "icon": "$media:layered_image",
  "label": "$string:PushMessageAbility_label",
  "startWindowIcon": "$media:startIcon",
  "startWindowBackground": "$color:start_window_background",
  "launchType": "singleton",
  "exported": false,
  "skills": [
    // 保持现有skill对象不变
    {
      "actions": [
        "com.app.action"
      ]
    },
    // 新增一个独立的skill对象，配置actions参数
    {
      "actions": [
        "action.ohos.push.listener"
      ]
    }
  ]
  // ...
}

应用服务端调用REST API推送MDM消息，消息详情可参见场景化消息API接口功能介绍，请求示例如下。
```
// Request URL
POST "https://push-api.cloud.huawei.com/v3/[projectId]/messages:send"

// Request Header
Content-Type: application/json
Authorization: Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****
push-type: 11

// Request Body
{
  "payload": {
    "data": "携带的MDM管理指令数据"
  },
  "target": {
    "token": ["MAMzLg**********lPW"]
  }
}
```
- [projectId]：项目ID，登录AppGallery Connect网站，选择“开发与服务”，在项目列表中选择对应的项目，左侧导航栏选择“项目设置”，在该页面获取。
- Authorization：JWT格式字符串，可参见Authorization获取。
- push-type：11表示MDM消息场景。
- token：Push Token，可参见获取Push Token获取。
- data：携带的MDM管理指令数据，字符串类型。详情请参见data。
消息下发后会直接拉起应用并将数据传递，您可以在receiveMessage()方法中获取消息数据。

目录

推送MDM消息

场景介绍

约束与限制

开通权益

频控规则

开发步骤