Mobile Platform as a Service:Message Push Service FAQ

Perguntas gerais

Requisitos de permissão

No Android 6.0 e versões posteriores, os usuários devem conceder manualmente permissões ao telefone, como leitura e gravação no cartão SD. Para garantir a precisão dos envios, oriente os usuários a conceder as permissões necessárias ao serviço de push de mensagens.

Falha na impressão de logs

Durante testes em um telefone Meizu, logs como log.d e log.i podem não ser impressos. Para resolver esse problema, acesse Settings > Accessibility > Developer options e ative Advanced log output. Caso enfrente problemas de desenvolvimento, defina tag=mpush para filtrar os logs.

Perguntas relacionadas ao Android

Problema de análise de porta nas baselines 10.1.60.5 a 10.1.60.7

Em um ambiente Apsara Stack, configurar um servidor de push em uma porta diferente de 443 causa falha na análise e erro de conexão.

Solução:

• Se você empacota usando um arquivo de configuração, modifique-o da seguinte forma:

    // Omit other parts of the config file. Add a backslash (\) and a space before the custom port number.
    {
        "pushPort":"\\ 8000",
    }

• Caso não utilize um arquivo de configuração no empacotamento, modifique o valor de rome.push.port no arquivo AndroidManifest.xml conforme abaixo:

    // Add a backslash (\) and a space before the port number.
    <meta-data
        android:name="rome.push.port"
        android:value="\ 8000" />

Impossibilidade de enviar pushes após integrar canais de terceiros como Huawei e Xiaomi

Esse problema ocorre quando a opção de canal no console de push do mPaaS está desativada. Para exemplos de código, instruções de uso e observações importantes, consulte Exemplo de código.

Geração de ad-token (deviceId) de push

O servidor gera um deviceId com base na Identidade Internacional de Assinante Móvel (IMSI) e na Identidade Internacional de Equipamento Móvel (IMEI). Por isso, oriente os usuários a conceder a permissão READ_PHONE_STATE.

Requisitos de versão do EMUI e Huawei Mobile Services para notificações PUSH

As notificações push possuem requisitos de versão para o Emotion UI (EMUI) e o Huawei Mobile Services. O EMUI é um sistema operacional desenvolvido pela Huawei com base na plataforma Android. Para detalhes sobre os requisitos de versão, consulte Condições para um dispositivo receber mensagens de push da Huawei.

Falha na impressão de logs em um telefone Huawei

No discador do telefone, insira ##2846579## para abrir o menu de engenharia. Acesse Background settings > LOG settings e selecione AP Log. Reinicie o telefone para aplicar as alterações.

Códigos de erro de push da Huawei

Para mais informações sobre códigos de erro, consulte Códigos de erro do lado do cliente e Códigos de erro do lado do servidor no site oficial da Huawei.

Modelos e versões de sistema compatíveis com push OPPO

Atualmente, o push OPPO é compatível com modelos OPPO com ColorOS 3.1 ou superior, modelos OnePlus 5/5T e posteriores, além de todos os modelos realme.

O ColorOS é um sistema operacional móvel desenvolvido pela OPPO, baseado na plataforma Android.

Códigos de erro de push OPPO

Se o push OPPO não funcionar, pesquise por OPPO onRegister error = nos logs do cliente para obter o código de erro. Em seguida, consulte a lista de códigos de erro da OPPO para identificar a causa.

Modelos e versões de sistema compatíveis com push vivo

A tabela a seguir mostra os modelos compatíveis e as versões mínimas de sistema para o SDK. Para outras dúvidas sobre o push vivo, consulte Perguntas frequentes sobre vivo Push.

Códigos de erro de push vivo

Caso o push vivo não funcione, pesquise por fail to turn on vivo push state = nos logs do cliente para obter o código de status. Depois, consulte Códigos de status públicos para identificar a causa.

Solução de problemas comuns no Android

1. Verifique se o arquivo Manifest está configurado corretamente.

2. Confirme se o appId (Huawei, Xiaomi, vivo), appSecret (Xiaomi, OPPO), appKey (OPPO, vivo) e ALIPUSH_APPID (mPaaS) correspondem aos aplicativos registrados nas respectivas plataformas de desenvolvedor.

3. Visualize os logs do logcat com a tag mpush.

Perguntas relacionadas ao iOS

Notificações com o aplicativo em primeiro plano

Por padrão, a Apple entrega mensagens quando um aplicativo está em primeiro plano, mas não as exibe. Para mostrar notificações nessa situação, implemente uma solução personalizada.

Status da mensagem é NoBindInfo

O status NoBindInfo indica que um push foi enviado usando um UserId, mas nenhuma informação de vínculo foi encontrada para esse UserId. Primeiro, confirme se o cliente chamou a interface de vínculo. Verifique também se o appId e o workspaceId correspondem.

Status da mensagem é BadDeviceToken

Este status ocorre apenas em pushes para iOS e indica que o token usado para o push é inválido. Primeiramente, verifique se o ambiente do certificado está correto.

• Se o aplicativo for empacotado com um certificado de desenvolvimento, configure um certificado de ambiente de desenvolvimento no console de push. Ao depurar em um dispositivo real com o Xcode, use um certificado de desenvolvimento.

• Quando o aplicativo for empacotado com um certificado de produção, configure um certificado de ambiente de produção no console de push.

Status da mensagem é DeviceTokenNotForTopic

Esse status aparece exclusivamente em pushes para iOS e sinaliza que o token não corresponde ao BundleId do certificado de push. Verifique se o certificado está correto e se corresponde ao BundleId do cliente empacotado.

Mensagens não recebidas em um telefone iOS, mas com status ACKED

Para pushes iOS, o status ACKED significa que a mensagem foi entregue com sucesso ao Apple Push Notification service (APNs). Confirme se as permissões de push estão ativadas e se o aplicativo está sendo executado em segundo plano.

Por padrão, a Apple entrega mensagens quando um aplicativo está em primeiro plano, mas não as exibe. Para mostrar notificações nessa situação, implemente uma solução personalizada.

Problemas de chamada RPC

Se ocorrer uma exceção durante uma chamada de recurso via solicitação RPC, consulte Códigos de resultado do Security Guard ou Códigos de resultado do Gateway para solucionar o problema.