# 消息推送使用指南

# 一、使用前须知

App 消息推送是统一管理向 App 用户推送消息的服务,此消息推送功能是基于腾讯云即时通讯IM的移动推送服务实现,开发者需前往腾讯云使用「推送服务」,并创建对应的产品、应用以及完成相关配置后方可使用。为方便开发者更好地理解整体逻辑,需认真阅读本章节的内容:

  • 首先,前往腾讯云使用即时通讯 - 推送服务,创建腾讯即时通讯应用以及完成相关配置,以获得对应 APPKEY 和 APPID 等信息
  • 然后,在开发者工具中配置启用消息推送功能,并按照开发指南进行使用
  • 最后,消息推送服务的相关管理功能也在腾讯云控制台进行操作

# 1、关于合规指南

根据监管部门要求,使用 SDK 时必须在《隐私政策》中告知终端用户 SDK 使用用途,并且在终端用户未同意《隐私政策》前不得初始化任何 SDK。请确保你开发或运营的应用有符合监管要求的《隐私政策》文本。同时请你务必明确告知终端用户您的应用使用了移动推送服务。

# 2、关于问题反馈

  • 如果是小程序多端框架的问题,可联系多端小助手进入官方技术交流群进行处理
  • 如遇到消息推送的功能或者相关问题,可点此加入推送服务的官方群反馈,或者前往腾讯云提工单进行处理

# 二、操作指南

# 1、创建应用

  • 应用创建后即可在控制台中进行接入推送服务;以及可在在「操作」列查看应用详情和密钥

# 2、接入配置

  • 点击「接入配置」,切换至刚创建的应用即可申请免费试用该服务
  • 开通「免费试用」后即可进入接入配置页面完成相关配置

# 3、微信开发者工具配置推送服务插件

  • 下载版本号 ≥ 1.06.2410152 的 nightly 版开发者工具
  • Android 最低版本为 1.4.0,推荐使用最新版本
  • iOS 最低版本为 1.3.31,推荐使用最新版本
  • 需在开发者工具 project.miniapp.json 中勾选开启腾讯云消息推送功能,并且配置消息推送插件的版本号信息
  • 如果是 iOS,则还需要配置 businessID、NSEBundleID、NSEProfilePath、NSEDistributetProfilePath、TIMPushAppGroupId等信息
  • Android 与 iOS 在开发者工具的配置使用指南,详情可查看快速接入 腾讯云 IM Push

# 4、厂商通道配置

# 5、消息推送相关的客户端 API

# 6、更多高级功能

# 7、常见问题

# 7.1 如何触发 iOS 消息通知系统授权弹窗

  • 按照文档调用registerPush 即可触发ios 消息通知的系统授权弹窗。但是,必须在 App 用户同意了隐私政策,并且确定为 App 用户开始提供推送服务后,再调用该接口使用推送服务。否则可能因提前获取用户隐私导致上架失败。

# 7.2 如何判断用户是否授权消息通知的权限

  • 开发者可以通过getAppAuthorizeSetting接口判断用户已将哪些权限授权给 App,具体可查看 notificationAuthorized、notificationAlertAuthorized、notificationBadgeAuthorized、notificationSoundAuthorized 的返回值。

# 7.3 其他常见问题