MobPush开发过程常见问题

Android端Scheme跳转首页的实现中，APP在前台跳转正常，而后台跳转失败，这是因为方案设计问题导致的，需检查跳转逻辑确保在后台也能正确触发跳转操作。

获取回调参数的具体方法请查阅API接口文档中的scheme跳转部分，以获取详细指引。

在使用OPPO推送时，当配置为对所有人群进行推送时，有的OPPO设备接收不到推送，这是因为OPPO推送的全量推送规则有时间延迟限制，新注册的设备当天可能不会立即生效，需等到次日才能接收推送。对于单一设备推送，则没有这个时间限制。

Android端的厂商推送打开通知不一定都会有回调，其中OPPO推送没有接收通知和打开通知的回调，而FCM通道在应用处于后台或被杀掉时没有接收通知和打开通知的回调。

若应用在前台时MobPush通道推送接收不到，需要检查以下步骤：确保SDK已正确初始化、权限设置无误、没有网络异常等可能的干扰因素。

在调用MobPush.setClickNotificationToLaunchMainActivity()后，如果设置为false，但点击通知仍启动主页，这是由于不同通道的实现差异，目前仅对MobPush通道、魅族通道、小米通道有效。对于华为通道、OPPO通道、FCM通道，即使调用此方法也不会影响默认启动主页的机制。

在接入OPPO和VIVO推送时，需要关注通知权限的开关问题。对于OPPO，应用在未集成OPPO PUSH前，通知栏权限默认关闭；接入后，ColorOS3.1至5.0版本的OPPO手机在用户激活应用后，通知栏权限会默认打开，但若在旧版本应用中手动关闭，则需卸载旧版本并安装新版本（集成OPPO PUSH）并激活，通知栏才会默认打开。ColorOS5.1及以后的版本手机，通知栏权限由系统统一关闭，用户需手动打开。VIVO集成VPUSH后，通知权限总开关基本默认打开，但类别开关默认关闭，需要用户手动打开。

在接收小米手机推送时，需先确认通知权限是否开启，并检查通知栏里的不重要通知中是否有对应应用的通知。

应用通知权限未打开状态下，打开通知权限后可能接收不到推送，此时需杀掉进程，重新启动APP后再次推送。

接收回调和点击通知回调并非每次都一定会被调用，取决于推送通道、厂商和实现方式的不同。例如，MobPush通道会调用接收回调和点击通知回调，而华为厂商通道仅提供点击通知回调。

在设置标签成功后，进行通过标签推送时若接收不到推送，可能是因为设备标签同步延迟，建议等待几分钟再进行推送。

一个APP的同一设备只能对应一个别名，新设置的别名会覆盖掉之前的。不同设备之间不能设置相同的别名，最终设置的设备别名生效，其他设备的别名将失效。

在Android 9设备上获取不到注册ID时，需确认targetSdkVersion大于27，并在AndroidManifest.xml的application标签中添加android:usesCleartextTraffic="true"。

若同时使用了Firebase的其他产品（如ads等）与FCM厂商推送配置，可能会遇到编译时报错问题，解决方法是确认配置的先后顺序或使用特定的配置方式来避免冲突。

接入vivo厂商推送时，通知权限开关不需要特别处理。若发送推送成功，但vivo设备未接收到推送，可能是因为其他配置问题，需检查vivo厂商推送的相关配置。

配置了厂商推送的信息后，若发现AppKey不完整，可通过在配置有问题的地方加入空格来解决gradle版本过高的问题。

在华为厂商推送中，若有的华为设备无法接收离线消息，需检查华为厂商参数配置是否正确，并确认设备的EMUI版本，低于5.0可能不支持离线消息，可尝试升级设备里的华为移动服务应用。

如果MobPush的厂商推送与应用使用的其他第三方产品中的厂商推送发生冲突，需在MobTech配置中排除冲突的厂商信息。

对于魅族厂商推送，如果客户端debug log输出注册成功，但在推送时接收不到推送或离线推送接收不到，可能是因为魅族厂商推送监听回调只取AndroidManifest.xml中配置的第一个Receiver，解决方法是自定义一个Receiver继承自MzPushMessageReceiver，实现所有方法，并在其中调用MobPush的魅族回调和第三方产品的魅族回调，然后在AndroidManifest.xml中进行配置。

配置了魅族厂商推送后，如果客户端debug log输出注册成功，但推送时接收不到推送或离线推送接收不到，可能是因为厂商推送监听回调只取第一个配置的Receiver，解决方法是自定义一个Receiver继承自MzPushMessageReceiver，实现所有方法，并在其中调用MobPush的魅族回调和第三方产品的魅族回调，然后在AndroidManifest.xml中进行配置。

在配置了魅族厂商推送后，如果客户端debug log输出注册成功，但推送接收不到或离线推送接收不到，可能是因为魅族厂商推送监听回调只取第一个配置的Receiver，解决方法是自定义一个Receiver继承自MzPushMessageReceiver，实现所有方法，并在其中调用MobPush的魅族回调和第三方产品的魅族回调，然后在AndroidManifest.xml中进行配置。

MobPush支持角标功能，需调用MobPush.setShowBadge(true)来开启。对于华为厂商通道，EMUI 8.0及以上版本支持角标功能，若需要在华为厂商推送的设备上显示角标，需在服务端推送时在extrasMapList参数中新增androidBadgeClass参数，参数值为应用入口Activity的全路径。

MobPush支持多包名，可根据应用的不同环境或功能需求进行配置。

一个设备应用可以设置多个标签，标签尽量使用英文，避免使用中文或特殊字符，以确保推送成功。不同设备可以同时设置相同的标签。

MobPush的注册ID一般情况下不会发生改变，但在卸载重装或设备恢复出厂设置等情况下可能会发生改变。注册ID的长度可能会因服务端内部优化而发生变化，不固定。

除了FCM厂商无法通过StopPush接口关闭推送，TCP以及其他厂商通道的推送可以正常关闭。

如果应用打开通知权限后仍无法收到推送，请先检查MobPush是否在初始化时更新了记录的通知权限状态，若初始化时通知权限关闭，则需重启APP更新记录。若需要实时更新，可以调用特定方法进行处理。

若无法统计到厂商点击，需在点击通知打开的Activity的onCreate中添加特定方法。

华为厂商的长文本样式无效时，确保标题(title)为必填项。

华为厂商解析intent为空时，考虑到不同设备版本的问题，可能需要升级设备的华为移动服务应用以获得兼容性。详细解决方案可查阅自定义点击消息动作的相关文档。

推送下发逻辑在应用进程在线时通过MobTech通道处理，应用进程结束或进程被杀死时，推送会进入离线池，在离线时间内，当用户再次打开APP，推送会再次下发。默认离线时间是1天，但可以自定义为最高30天。

通知与自定义消息的区别在于，通知是常规推送类型，通过系统层面展示在手机的通知栏，而自定义消息实际上是透传消息，需要应用进程存活，服务端将推送的body等参数下发到客户端，由客户端自行处理。

regsiterid和别名都是设备的唯一标识，推送时推送到设备上，regsiterid是MobTech生成的，别名是自定义的设备标识，二者本质都是唯一的，且同一台设备只能设置一个别名。regsiterid和别名均适用于单点登录。

标签功能用于区分用户群体，可以理解为群体推送，适用于用户群体区分和多点登录逻辑。

推送成功后，后台统计不到数据可能是因为推送权限关闭或推送任务进入离线池，当用户再次打开APP收到推送时，后台才能统计到数据。

如果推送手机收不到，首先检查是否是推送环境不匹配，其次确认应用在运行状态下是否能收到推送。如果在线可以收到推送，但在杀死APP后收不到，可以通过smartpush工具校验证书。

推送有测试环境和正式环境之分，iOS推送区分开发环境和生产环境，需要在代码中设置环境。

iOS支持富媒体推送，需要iOS系统10以上设备，并按照示例设置推送扩展，即可实现图片播放。对于音频播放，由于应用进程被杀死，只能播放本地音频。

静默推送与正常推送的区别在于，正常推送会显示推送内容、声音，应用处于后台或被kill时可收到推送信息，但不会走任何回调，而静默推送没有内容、声音，不需点击或进入APP就会执行回调，用户感知不明显。

iOS支持自定义声音和跳转功能，可通过在项目中添加声音文件并设置名称，以及在对应的ViewController中设置跳转标识来实现。Android端同样支持自定义声音和跳转，方法与iOS类似。

MobTech后台支持设置IP白名单，未设置时默认所有IP均可进行推送。若只允许特定IP进行推送，需设置白名单。

推送任务有多种限制，包括广播限制、接口频率限制等，具体限制需查阅详细文档。

推送任务可根据地区进行地理范围推送，目前支持精准到市级的推送范围。

服务端推送报错时，通常与参数设置或加密相关，可通过postman尝试参数调整。

推送回调有时不能触发，可能是方法没有每次都调用，需要确保回调方法的正确触发。

推送后台显示已取消状态时，可能是因为rid或别名传错、未入库或推送权限关闭，需检查相关配置。

推送海外时，需要切换到海外服务器，使用特定接口进行推送，并使用海外域名。企业账号证书也可以用于MobPush。

若推送打开APP后能收到图片，但关闭APP后收不到，需要确认是否添加了扩展。

推送后台上传证书时出现错误，可能是因为使用了同时支持开发环境和生产环境的证书，需要根据文档制作只支持开发环境的证书。

API请求时提示5001：服务端未知错误，问题通常与请求参数有关，需检查参数设置。

关于Push推送的一些统计说明包括：新增用户数、活跃用户数、目标数、下发数、到达数、点击数等，这些数据都精确到小数点后两位。

在Flutter上生产环境推送APNS收不到，可能是因为通过flutter build iOS打包发布蒲公英后选择iOS正式环境推送的问题，解决方法是改用achiver打ADHOC类型的ipa包发布，然后重新安装测试，这样前台和后台才能正确接收推送。

本文如未解决您的问题请添加抖音号：51dongshi（抖音搜索懂视），直接咨询即可。