> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Huawei 授权

> 将华为应用连接到 OneSignal 进行推送通知的分步指南，包括 PushKit 设置、API 密钥配置以及针对中国用户应用的华为可选消息自分类。

## 要求

要在华为 Android 设备上使用 OneSignal 启用推送通知，您需要：

* [华为开发者账户](https://developer.huawei.com/consumer/en/console)
* 在[华为 AppGallery Connect](https://developer.huawei.com/consumer/en/doc/distribution/app/agc-create_app) 中注册的 Android 移动应用
* [OneSignal 账户](https://onesignal.com/)
* （可选）如果针对中国用户并需要通过 `Huawei_category` API 字段进行更精确的消息分类，需要[华为自分类权限](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835#section1653845862216)

***

## 设置

### 1. 启用 PushKit

前往 [AppGallery Connect > 项目设置 > PushKit](https://developer.huawei.com/consumer/en/doc/distribution/app/agc-enable_service#h1-1574823053380) 并启用 PushKit。

### 2. 获取您的华为推送凭据

打开 [AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html) 并从**我的应用**部分选择您的应用。

<Frame caption="在 AppGallery Connect 中导航到您的应用">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/f36e4ff-Huawei_AppGallery_Connect_LandingPage_With_Myapps_highlight.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=b30a9076c3775da810a8d90cb0648f16" width="1269" height="805" data-path="images/docs/f36e4ff-Huawei_AppGallery_Connect_LandingPage_With_Myapps_highlight.png" />
</Frame>

前往**所有服务 > 变现**下的**应用内购买**。复制以下信息：

* **包名**
* **客户端 ID**
* **客户端密钥**

<Frame caption="复制您的包名、客户端 ID 和客户端密钥">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/fc70624-huawei.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=ebbbda6c47d3b6d968a05bc285d20f5f" width="1847" height="849" data-path="images/docs/fc70624-huawei.png" />
</Frame>

### 3. 将凭据添加到 OneSignal

在 OneSignal 控制台中，前往您的应用**设置 > 推送和应用内 > 华为 Android (HMS)**。

<Frame caption="在 OneSignal 中选择华为 Android">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/huawei-android-settings.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=9176643dd1ce25e5fc083be7346c2249" width="2420" height="1770" data-path="images/docs/huawei-android-settings.png" />
</Frame>

点击**激活**并粘贴您的凭据：

* **包名**
* **客户端 ID**（在**应用 ID** 字段中）
* **客户端密钥**（在**应用密钥**字段中）

然后点击**下一步**。

<Frame caption="在 OneSignal 中输入华为推送凭据">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/huawei-configuration.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=362d6263e48199ba542fbcb72d30e0a8" width="2420" height="1770" data-path="images/docs/huawei-configuration.png" />
</Frame>

### 4. （可选）申请华为自分类权限

华为要求向**中国用户**发送通知的 AppGallery 应用对消息进行分类。他们提供**自动分类**，但**自分类**可以为关键消息类型提供更多控制和更高的发送限制。

#### 如何申请

1. 按照华为的[自分类申请指南](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835#section1653845862216)进行操作。
2. 一旦获得批准，在 OneSignal API 中使用 `Huawei_category` 字段对您的消息进行分类。

#### 支持的 `Huawei_category` 值

| 类别                | 描述          |
| ----------------- | ----------- |
| `IM`              | 即时消息        |
| `VOIP`            | IP 语音服务     |
| `SUBSCRIPTION`    | 订阅内容通知      |
| `TRAVEL`          | 旅行信息（如机票更新） |
| `HEALTH`          | 健康和养生更新     |
| `WORK`            | 工作相关提醒      |
| `ACCOUNT`         | 账户活动警报      |
| `EXPRESS`         | 物流/配送更新     |
| `FINANCE`         | 金融/银行警报     |
| `DEVICE_REMINDER` | 设备级系统提醒     |
| `MAIL`            | 电子邮件客户端消息   |
| `MARKETING`       | 营销或推广内容     |

<Note>
  默认类别是 `MARKETING`，根据[三级分类](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-restriction-description-0000001361648361#section199311418515)，每日发送限制为 2-5 次。

  **重要：**[分类违规](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/volation-classification-violation-penalty-criteria-0000001356540133)可能导致罚款或投递限制。
</Note>

***

## 华为徽章

OneSignal 支持通过 API 和仪表板在华为设备上设置应用图标徽章计数。创建推送通知时，请使用 `huawei_badge_class`、`huawei_badge_set_num` 和 `huawei_badge_add_num` 参数。

有关完整详细信息和示例，请参阅[徽章](./badges#huawei-badges)。

***

<Check>
  您现在已获得使用 OneSignal 发送华为推送通知的授权！
  下一步：

  * [集成 OneSignal SDK](./mobile-sdk-setup)
</Check>

***