# 消息推送使用指南 ## 一、使用前须知 App 消息推送是统一管理向 App 用户推送消息的服务，此消息推送功能是基于[腾讯云即时通讯 IM 的移动推送](https://cloud.tencent.com/document/product/269/100621)服务实现，开发者需前往腾讯云使用「推送服务」，并创建对应的产品、应用以及完成相关配置后方可使用。为方便开发者更好地理解整体逻辑，需认真阅读本章节的内容： - 首先，前往腾讯云使用即时通讯 - 推送服务，创建[腾讯即时通讯应用](https://cloud.tencent.com/document/product/269/32577)以及完成相关配置，以获得对应 APPKEY 和 APPID 等信息 - 然后，在开发者工具中配置启用消息推送功能，并按照[开发指南](https://cloud.tencent.com/document/product/269/111208)进行使用 - 最后，消息推送服务的相关管理功能也在腾讯云控制台进行操作 ### 1、关于合规指南 根据监管部门要求，使用 SDK 时必须在《隐私政策》中告知终端用户 SDK 使用用途，并且在终端用户未同意《隐私政策》前不得初始化任何 SDK。请确保你开发或运营的应用有符合监管要求的《隐私政策》文本。同时请你务必明确告知终端用户你的应用使用了移动推送服务。 - [IM SDK 合规使用指南](https://cloud.tencent.com/document/product/269/97564) ### 2、关于问题反馈 - 如果是小程序多端框架的问题，可前往[社区](https://developers.weixin.qq.com/community/develop/mixflow)反馈。 - 如遇到消息推送的功能或者相关问题，可[点此](https://zhiliao.qq.com/s/c5GY7HIM62CK/cKIIKIIM62CL)加入推送服务的官方群反馈，或者前往[腾讯云提工单](https://console.cloud.tencent.com/workorder/category)进行处理 ## 二、操作指南 ### 1、创建应用 - 前往[腾讯云推送服务控制台](https://console.cloud.tencent.com/im/new-user-guide)，进入「即时通讯 IM」控制台，如果还没创建应用，需先完成应用创建 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202410151943654.png) - 应用创建后即可在控制台中进行接入推送服务；以及可在「操作」列查看应用详情和密钥 ### 2、接入配置 - 点击「接入配置」，切换至刚创建的应用即可申请免费试用该服务 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202410151947987.png) - 开通「免费试用」后即可进入接入配置页面完成相关配置 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202410151948269.png) ### 3、微信开发者工具配置推送服务插件 - 下载版本号 ≥ 1.06.2410152 的 [nightly 版](/miniprogram/dev/devtools/log.md)开发者工具 - Android 最低版本为 1.4.0，推荐使用[最新版本](/miniprogram/dev/platform-capabilities/miniapp/changelog/android/changelog) - iOS 最低版本为 1.3.31，推荐使用[最新版本](/miniprogram/dev/platform-capabilities/miniapp/changelog/ios/changelog) - 需在开发者工具 project.miniapp.json 中勾选开启腾讯云消息推送功能，并且配置消息推送插件的版本号信息 - 如果是 iOS，则还需要配置 businessID、NSEBundleID、NSEProfilePath、NSEDistributetProfilePath、TIMPushAppGroupId 等信息 - Android 与 iOS 在开发者工具的配置使用指南，详情可查看[快速接入 腾讯云 IM Push](https://cloud.tencent.com/document/product/269/111208) ### 4、厂商通道配置 - [Android 厂商通道配置](https://cloud.tencent.com/document/product/269/111825) - [iOS 厂商通道配置](https://cloud.tencent.com/document/product/269/111825) ### 5、消息推送相关的客户端 API - 支持的客户端 API 列表，详情可查看[https://cloud.tencent.com/document/product/269/111826](https://cloud.tencent.com/document/product/269/111826) ### 6、更多高级功能 - 自定义铃声：接入指南可查看[https://cloud.tencent.com/document/product/269/100646](https://cloud.tencent.com/document/product/269/100646) - 自定义点击跳转：接入指南可查看[https://cloud.tencent.com/document/product/269/100648](https://cloud.tencent.com/document/product/269/100648) - 如需了解更多更新的能力支持，可前往腾讯云 IM Push 官方文档查看功能的[更新日志](https://cloud.tencent.com/document/product/269/102807) ### 7、常见问题 #### 7.1 如何触发 iOS 消息通知系统授权弹窗 - 按照文档调用[registerPush](https://cloud.tencent.com/document/product/269/111826) 即可触发 iOS 消息通知的系统授权弹窗。但是，必须在 App 用户同意了隐私政策，并且确定为 App 用户开始提供推送服务后，再调用该接口使用推送服务。否则可能因提前获取用户隐私导致上架失败。 #### 7.2 如何判断用户是否授权消息通知的权限 - 开发者可以通过[getAppAuthorizeSetting](/miniprogram/dev/platform-capabilities/miniapp/api/diffapi/getAppAuthorizeSetting)接口判断用户已将哪些权限授权给 App，具体可查看 notificationAuthorized、notificationAlertAuthorized、notificationBadgeAuthorized、notificationSoundAuthorized 的返回值。 #### 7.3 如何设置应用角标 - 角标设置的功能还在开发中，敬请期待。 #### 7.4 其他常见问题 - 可查看[常见问题](https://cloud.tencent.com/document/product/269/111208#c5c81d47-d0b1-450f-85f0-93d5d0eb0897)