Mobile Platform as a Service:APIs do lado do cliente

O Mobile Push Service (MPS) fornece APIs de cliente para vincular e desvincular pares usuário-dispositivo e relatar dispositivos de canais de terceiros.

A classe MPPush na camada intermediária do mPaaS encapsula todas as APIs do MPS, incluindo vinculação, desvinculação e relato de dispositivos de canais de terceiros. O SDK do gateway móvel implementa as chamadas RPC para esses métodos.

Vincular

• Definição do método

  Vincula um ID de usuário a um ID de dispositivo para permitir o envio de mensagens push a usuários específicos. Chame este método em uma subthread.

    public static ResultPbPB bind(Context ctx, String userId, String token)

• Parâmetros

  Parâmetro	Tipo	Descrição
  ctx	Context	Um Context não vazio.
  userId	String	Identificador único do usuário. Não precisa ser o ID real do sistema de usuários, mas deve ter correspondência unívoca com um usuário.
  token	String	ID do dispositivo emitido pelo gateway do MPS.

• Valor de retorno

  Parâmetro	Descrição
  success	Indica se a chamada da API foi bem-sucedida. true: A chamada teve êxito. false: A chamada falhou.
  code	Código do resultado da operação.
  name	Nome do código de resultado.
  message	Descrição do código de resultado.

  Descrição dos códigos de resultado

  Código de resultado	Nome do código de resultado	Mensagem	Descrição
  3012	NEED_USERID	need userid	O parâmetro de entrada userId está vazio.
  3001	NEED_DELIVERYTOKEN	need token	O parâmetro de entrada token está vazio.

• Exemplo

    private void doSimpleBind() {
        final ResultPbPB resultPbPB = MPPush.bind(getApplicationContext(), mUserId, PushMsgService.mAdToken);
        handlePbPBResult("Bind user operation", resultPbPB);
    }

Desvincular

• Definição do método

  Desvincula um ID de usuário de um ID de dispositivo. Chame este método em uma subthread.

  public static ResultPbPB unbind(Context ctx, String userId, String token)

• Parâmetros

  Parâmetro	Tipo	Descrição
  ctx	Context	Um Context não vazio.
  userId	String	Identificador único do usuário. Não precisa ser o ID real do sistema de usuários, mas deve ter correspondência unívoca com um usuário.
  token	String	ID do dispositivo emitido pelo gateway do MPS.

• Valor de retorno

  Mesmo valor de retorno do método de vinculação.

• Exemplo

    private void doSimpleUnBind() {
        final ResultPbPB resultPbPB = MPPush.unbind(getApplicationContext()
                , mUserId, PushMsgService.mAdToken);
        handlePbPBResult("Unbind user operation", resultPbPB);
    }

Relatar dispositivo de canal de terceiros

• Definição do método

  Relata o ID do dispositivo de canal de terceiros e o Ad-token do mPaaS ao núcleo do MPS, que vincula os dois identificadores de forma síncrona. Após a vinculação, é possível enviar mensagens push pelo canal de terceiros.

  O framework chama este método internamente. Chame-o manualmente novamente para evitar possíveis falhas na invocação do SDK.

    public static ResultPbPB report(Context context, String deliveryToken, int thirdChannel, String thirdChannelDeviceToken)

• Parâmetros

  Parâmetro	Tipo	Descrição
  ctx	Context	Um Context não vazio.
  deliveryToken	String	ID do dispositivo (Ad-token) emitido pelo gateway do MPS.
  thirdChannel	int	Canal de terceiros. Valores válidos: 2: Apple 4: Xiaomi 5: Huawei 6: FCM 7: OPPO 8: vivo
  thirdChannelDeviceToken	String	ID do dispositivo do canal do fornecedor.

• Valor de retorno

  Mesmo valor de retorno do método de vinculação.

• Exemplo

    private void doSimpleUploadToken() {
        final ResultPbPB resultPbPB = MPPush.report(getApplicationContext(), PushMsgService.mAdToken
                , PushOsType.HUAWEI.value(), PushMsgService.mThirdToken);
        handlePbPBResult("Third-party push identifier reporting operation", resultPbPB);

Solução de problemas

Se ocorrer uma exceção durante uma chamada RPC, consulte a Descrição dos códigos de resultado do Security Guard para solucionar o problema.