XuqmGroup-RNSDK/packages/push/README.md

# @xuqm/rn-push

XuqmGroup RN SDK 推送模块。自动检测设备厂商并完成推送 token 注册。

## 安装

```bash
pnpm add @xuqm/rn-common @xuqm/rn-push
```

Peer dependencies：`react-native >= 0.76`

## 使用

Push 不提供独立初始化或登录入口。宿主调用一次 `XuqmSDK.login()` 后，SDK 自动完成：
1. 检测设备厂商（华为/小米/OPPO/vivo/荣耀/FCM/APNs）
2. 从平台获取该厂商推送配置
3. 调用厂商 SDK 完成设备注册
4. 收到 token 后自动上报绑定到平台

```ts
import { PushSDK } from '@xuqm/rn-push'

// 通常不需要手动调用，XuqmSDK.login() 会自动触发
// 设置离线推送开关
await PushSDK.setOfflinePushEnabled(false)

// 设置免打扰时间段（24 小时制）
await PushSDK.setQuietHours('22:00', '08:00')

// 清除免打扰
await PushSDK.clearQuietHours()

// 主动登出（通常不需要，XuqmSDK.logout() 自动触发）
await PushSDK.logout()
```

## API

| API | 说明 |
|-----|------|
| `PushSDK.setOfflinePushEnabled(enabled)` | 设置离线推送开关 |
| `PushSDK.setQuietHours(start, end)` | 设置免打扰时间段 |
| `PushSDK.clearQuietHours()` | 清除免打扰设置 |
| `PushSDK.logout()` | 解绑推送 token |

## 支持厂商

HUAWEI / XIAOMI / OPPO / VIVO / HONOR / FCM / APNS

## 依赖

需要原生模块 `NativeModules.XuqmPushModule` 已链接到宿主 App。