Mobile Platform as a Service:API Android

A classe MPSync encapsula todas as operações da API Android para o serviço de sincronização móvel (MSS) do mPaaS, incluindo ciclo de vida da conexão, gerenciamento de sessão do usuário e callbacks de push de dados.

Na baseline 10.1.32 e posteriores, a classe MPSync na camada intermediária do mPaaS encapsula todas as operações da API do MSS. Acesse todos os recursos de sincronização móvel pelo objeto MPSync.

java.lang.Object
  - com.mpaas.mss.adapter.api.MPSync

Métodos públicos:

setup(Application app)

Declaração

public static void setup(Application application)

Descrição

Inicializa os serviços dos quais o MSS depende. Chame este método antes de initialize. Disponível apenas na baseline 10.1.60 e posteriores.

Parâmetros

Valor de retorno

Nenhum.

appToBackground()

Declaração

public static void appToBackground()

Descrição

Notifica o SDK cliente de que o aplicativo entrou em segundo plano e desconecta do servidor. Chame este método sempre que o aplicativo for para o segundo plano.

Chame-o no método onStop() da sua activity principal. Sem essa chamada, a conexão permanece ativa em segundo plano, o que aumenta o consumo de energia e o uso de dados.

Parâmetros

Nenhum.

Valor de retorno

Nenhum.

appToForeground()

Declaração

public static void appToForeground()

Descrição

Notifica o SDK cliente de que o aplicativo foi para o primeiro plano e estabelece conexão com o servidor. Chame este método sempre que o aplicativo retomar a execução.

Chame-o no método onResume() da sua activity principal.

Parâmetros

Nenhum.

Valor de retorno

Nenhum.

clearUserInfo()

Declaração

public static void clearUserInfo()

Descrição

Desconecta o usuário.

Parâmetros

Nenhum.

Valor de retorno

Nenhum.

initialize(Context ctx)

Declaração

public static void initialize(Context ctx)

Descrição

Inicializa o serviço de sincronização móvel. Chame este método antes de usar o serviço.

Chame apenas uma vez durante o ciclo de vida do aplicativo.

Parâmetros

Valor de retorno

Nenhum.

isConnected()

Declaração

public static boolean isConnected()

Descrição

Indica se o serviço de sincronização móvel está conectado no momento.

Parâmetros

Nenhum.

Valor de retorno

Retorna true se estiver conectado; caso contrário, retorna false.

registerBiz(String bizType, ISyncCallback syncCallback)

Declaração

public static void registerBiz(String biz, ISyncCallback callback)

Descrição

Registra um callback para receber dados de negócios. O SDK cliente invoca a implementação de syncCallback ao receber dados sincronizados.

Chame este método para cada configuração de sincronização.

Parâmetros

Valor de retorno

Nenhum.

reportMsgReceived(SyncMessage syncMessag)

Declaração

public static void reportMsgReceived(SyncMessage msg)

Descrição

Chame este método após receber dados via push em syncCallback para confirmar o recebimento ao servidor. Sem a confirmação de reportMsgReceived, o servidor tenta entregar os dados até seis vezes e depois os exclui permanentemente.

Parâmetros

Valor de retorno

Nenhum.

unregisterBiz(String bizType)

Declaração

public static void unregisterBiz(String biz)

Descrição

Cancela o registro de uma configuração de sincronização. Após o cancelamento, o serviço deixa de invocar syncCallback para dados recebidos sob essa configuração.

Parâmetros

Valor de retorno

Nenhum.

updateUserInfo(String sessionId)

Declaração

public static boolean updateUserInfo(String sessionId)

Descrição

Internamente, chama LongLinkSyncService.getInstance().updateUserInfo(String userId, String sessionId). O userId é o ID de usuário definido em MPLogger. Chame este método sempre que userId ou sessionId mudar, quando uma sessão expirar ou quando o login automático for bem-sucedido. Nenhum parâmetro pode estar vazio. Retorna false se userId não estiver definido.

Parâmetros

Valor de retorno

Retorna true se as informações do usuário forem atualizadas com sucesso; caso contrário, retorna false se userId não estiver definido.