AI 助理
备案控制台
文档
输入文档关键字查找
首页

Android端辅助通道和弹窗问题的排查步骤

更新时间：
产品详情
我的收藏

概述

本文主要介绍Android端辅助通道和弹窗问题的排查步骤。

详细信息

参数检查

登录移动研发平台EMAS，选择移动推送后选择对应的应用，单击应用配置，确认各个平台上的相关参数一一对应，填写参数时请不要添加多余的空格。

终端集成确认

各通道初始化成功，可先在各厂商的控制台推送测试，然后再使用阿里云控制台或OpenAPI进行推送。

下面日志示例如果实际调试时不打印，在推送SDK初始化注册之前，将调试日志打开：

CloudPushService pushService = PushServiceFactory.getCloudPushService();
pushService.setLogLevel(CloudPushService.LOG_DEBUG);//ogLevel 支持设置：CloudPushService.ERROR | CloudPushService.INFO | CloudPushService.DEBUG | CloudPushService.OFF（关闭Log）
pushService.register(applicationContext, new CommonCallback() {...};

华为通道

华为通道初始化成功，如下图所示。若没有注册信息上报，确认注册成功，返回结果中包含token说明初始化成功。

huawei

小米通道

小米通道初始化成功，如下图所示。

xiaomi

GCM/FCM通道

GCM/FCM通道初始化成功，可以看到以下日志信息：

05-19 19:18:44.530 19153-19177/com.xxx D/MPS:GcmRegister: token from register: eWIXLYCNP0Q:APA91bFUAgxj6XYf5okyoCBnRPw1UwITndzXrvPDgbdI2N44PYm17hFEBiNXNQJrJ8bOG_xjw3c3UPDAhzNMTLNjlAKcjUanKyLA6E3k4wEmgZuhgUT02UMmMvH2LVA1L2Z4-l-cT_Ug

OPPO通道

OPPO通道是否注册成功，可以通过过滤MPS:OPush关键字查看。注册成功会打印“onRegister regid=****”相关日志，注册失败请检查参数是否正确填入，阿里云控制台上需要填写OPPO的MasterSecret，而不是appsecret，若找不到OPPO的MasterSecret，请咨询OPPO客服。

如果targetSdkVersion设置成26及以上，那么使用OPPO通道时需要设置NotificationChannel，NotificationChannel的相关介绍请参见Android 8.0以上设备接收不到推送通知，OPPO需要在推送控制台创建一个通知渠道，NotificationChannel的ID需要填写正确，各处都需要统一。

vivo通道

vivo通道是否注册成功，可以通过过滤MPS:vPush关键字查看，注册成功会打印getRegId regId:**相关日志，否则检查参数是否正确填入。

魅族通道

魅族通道初始化成功，可以看到以下日志信息：

说明：魅族控制台必须配置回执地址，详情请参见魅族辅助通道集成。

meizu

检查辅助弹窗配置

接入推送辅助通道，确保您使用最新的辅助通道扩展包。查看当前设备是否支持辅助弹窗：

  • 小米辅助弹窗：支持V2.3.0及以上版本
  • 华为辅助弹窗：支持V3.0.8及以上版本
  • 华为弹窗当前只支持EmotionUI 4.1及以上版本

指定打开的托管弹窗Activity，需要继承AndroidPopupActivity，并在AndroidManifest.xml中注册时需要声明属性android:exported=true。

import com.alibaba.sdk.android.push.AndroidPopupActivity;
public class PopupPushActivity extends AndroidPopupActivity {
    static final String TAG = "PopupPushActivity";
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    }
    /**
      * 实现通知打开回调方法，获取通知相关信息。
     * @param title     标题
     * @param summary   内容
     * @param extMap    额外参数
     */
    @Override
    protected void onSysNoticeOpened(String title, String summary, Map<String, String> extMap) {
        Log.d("OnMiPushSysNoticeOpened, title: " + title + ", content: " + summary + ", extMap: " + extMap);
    }
}

服务器端配置

注意：推送测试阶段建议不要使用全量推送，全量推送可能有统计新注册设备的延迟，容易误导用户。接入阶段建议按deviceID进行推送。

使用OpenAPI进行推送

  • OpenAPI 2.0的推送高级接口提供了AndroidPopupActivity、AndroidPopupTitle和AndroidPopupBody三个参数，分别用于设置辅助弹窗通知打开时跳转的Activity、通知标题以及通知内容（注意：StoreOffline参数也需要设置为true）；

  • 辅助弹窗仅在当前厂商通道设备的应用后台进程被清理时生效，对非接入厂商通道设备和在线的设备不生效。

  • 当辅助弹窗生效时，推送接口的Title、Body、AndroidActivity以及额外参数设置中的功能性设置（如声音、震动等）都不起作用；

PushRequest pushRequest = new PushRequest();
// 其余设置省略
// 推送类别-通知
pushRequest.setPushType("NOTICE");
// 标题
pushRequest.setTitle(dateFormat.format(new Date()));
// 内容
pushRequest.setBody("PushRequest body");
// 额外参数
pushRequest.setAndroidExtParameters("{\"k1\":\"android\",\"k2\":\"v2\"}");
// 设置辅助弹窗打开Activity
pushRequest.setAndroidPopupActivity("*****");
// 设置辅助弹窗通知标题
pushRequest.setAndroidPopupTitle("*****");
// 设置辅助弹窗通知内容
pushRequest.setAndroidPopupBody("*****");
// 设置离线存储
pushRequest.setStoreOffline(true);

使用阿里云控制台进行推送

登录移动研发平台EMAS，选择移动推送后选择对应的应用，在左侧导航栏选择创建消息>推送通知，在高级设置（选填）中，设置厂商通道必要参数，如下图所示。

问题仍未解决

若上述步骤仍未能定位并解决问题，即在最后使用OpenAPI高级接口时还是无法推送到厂商设备，您可以通过以下方式咨询问题，咨询时请务必提供AppKey、messageID以及deviceID。

  • 您可以提交工单，提交工单时请选择移动推送类目。
  • 或者加入钉钉群咨询问题：

适用于

  • 移动推送
文档推荐