AppServiceConnection Classe

Pacote:

com.microsoft.connecteddevices.remotesystems.commanding

• java.lang.Object
• • NativeBase
  • • com.microsoft.connecteddevices.remotesystems.commanding.AppServiceConnection

public class AppServiceConnection

Essa classe gerencia uma conexão com um serviço de aplicativo remoto específico.

Resumo do Construtor

Construtor	Description
AppServiceConnection()	Cria e inicializa uma instância dessa classe.
AppServiceConnection(@NonNull AppServiceInfo appServiceInfo)	Cria e inicializa uma instância dessa classe.

Resumo do método

Modificador e tipo	Método e descrição
void	close() Fecha a conexão com o serviço de aplicativo remoto. O aplicativo cliente deve chamar esse método sempre que for fechado ou interrompido pelo usuário ou pelo sistema.
AppServiceInfo	getAppServiceInfo() Obtém detalhes sobre o serviço de aplicativo de destino ao qual se conectar.
AsyncOperation<AppServiceConnectionStatus>	openRemoteAsync(@NonNull RemoteSystemConnectionRequest connection) Abre a conexão do serviço de aplicativo no dispositivo ou aplicativo remoto especificado. Se a conexão não for aberta, uma exceção será gerada.
Event<AppServiceConnection, AppServiceRequestReceivedEventArgs>	requestReceived() Evento para quando uma solicitação de serviço é recebida de um aplicativo remoto.
AsyncOperation<AppServiceResponse>	sendMessageAsync(@NonNull Map<String, Object> message) Envia uma mensagem para o serviço de aplicativo remoto e começa a escutar uma resposta. Esse método só deve ser chamado depois que a conexão foi aberta com êxito.
AsyncOperation<StatelessAppServiceResponse>	sendStatelessMessageAsync(@NonNull AppServiceInfo appServiceInfo, @NonNull RemoteSystemConnectionRequest connectionRequest, @NonNull Map<String, Object> message) Envia uma mensagem para o serviço de aplicativo remoto e escuta uma resposta. Esse método não estabelece uma conexão persistente e gerará uma exceção se for chamado quando a conexão já estiver aberta.
Event<AppServiceConnection, AppServiceClosedEventArgs>	serviceClosed() Evento para quando a conexão com o serviço de aplicativo é fechada. > **Observação:** No aplicativo cliente, o evento "serviço de aplicativo fechado" não é gerado quando o método 'close' é chamado (pelo cliente ou pelo host); ele só é gerado no aplicativo cliente para interrupções inesperadas de conexão. No aplicativo host, o evento _is_ é gerado quando o cliente chama 'close' (bem como para interrupções inesperadas).
void	setAppServiceInfo(@NonNull AppServiceInfo appServiceInfo) Especifica o serviço de aplicativo de destino ao qual se conectar.

Detalhes do construtor

AppServiceConnection

public AppServiceConnection()

Cria e inicializa uma instância dessa classe.

AppServiceConnection

public AppServiceConnection(@NonNull AppServiceInfo appServiceInfo)

Cria e inicializa uma instância dessa classe.

Parameters:

appServiceInfo -

AppServiceInfo para descrever o serviço de aplicativo a ser direcionado nessa conexão.

Detalhes do método

close

public void close()

Fecha a conexão com o serviço de aplicativo remoto. O aplicativo cliente deve chamar esse método sempre que for fechado ou interrompido pelo usuário ou pelo sistema.

getAppServiceInfo

public AppServiceInfo getAppServiceInfo()

Obtém detalhes sobre o serviço de aplicativo de destino ao qual se conectar.

Returns:

O objeto de informações do serviço de aplicativo de destino.

openRemoteAsync

public AsyncOperation openRemoteAsync(@NonNull RemoteSystemConnectionRequest connection)

Abre a conexão do serviço de aplicativo no dispositivo ou aplicativo remoto especificado. Se a conexão não for aberta, uma exceção será gerada.

Parameters:

connection - O RemoteSystemConnectionRequest, que especifica o dispositivo ou aplicativo ao qual se conectar.

Returns:

Uma operação assíncrona com um AppServiceConnectionStatus que indica o status da tentativa de conexão.

requestReceived

public Event requestReceived()

Evento para quando uma solicitação de serviço é recebida de um aplicativo remoto.

Returns:

A assinatura do evento

sendMessageAsync

public AsyncOperation sendMessageAsync(@NonNull Map message)

Envia uma mensagem para o serviço de aplicativo remoto e começa a escutar uma resposta. Esse método só deve ser chamado depois que a conexão foi aberta com êxito.

Parameters:

message - Um **Mapa** das chaves e valores a serem enviados. Os valores neste mapa devem seguir os seguintes tipos: Strings, primitives boxed, android.graphics.Point, android.graphics.Rect, java.util.Date, java.util.UUID, matrizes de primitivos, além de qualquer um dos tipos anteriores ou outros objetos Map que atendam a essa especificação.

Returns:

Uma operação assíncrona com um AppServiceResponse objeto , que representa a resposta do serviço de aplicativo remoto à mensagem que está sendo enviada.

sendStatelessMessageAsync

public static AsyncOperation sendStatelessMessageAsync(@NonNull AppServiceInfo appServiceInfo, @NonNull RemoteSystemConnectionRequest connectionRequest, @NonNull Map message)

Envia uma mensagem para o serviço de aplicativo remoto e escuta uma resposta. Esse método não estabelece uma conexão persistente e gerará uma exceção se for chamado quando a conexão já estiver aberta.

Parameters:

appServiceInfo - Um AppServiceInfo que identifica o serviço de aplicativo a ser ativado.

connectionRequest - Um RemoteSystemConnectionRequest que identifica o sistema remoto ao qual se conectar.

message - Um **Mapa** das chaves e valores a serem enviados. Para os tipos de valor com suporte,

Returns:

Uma operação assíncrona com um StatelessAppServiceResponse objeto , que representa a resposta do serviço de aplicativo remoto à mensagem que está sendo enviada.

serviceClosed

public Event serviceClosed()

Evento para quando a conexão com o serviço de aplicativo é fechada.

> **Observação:** No aplicativo cliente, o evento "serviço de aplicativo fechado" não é gerado quando o método 'close' é chamado (pelo cliente ou pelo host); ele só é gerado no aplicativo cliente para interrupções inesperadas de conexão. No aplicativo host, o evento _is_ é gerado quando o cliente chama 'close' (bem como para interrupções inesperadas).

Returns:

A assinatura do evento

setAppServiceInfo

public void setAppServiceInfo(@NonNull AppServiceInfo appServiceInfo)

Especifica o serviço de aplicativo de destino ao qual se conectar.

Parameters:

appServiceInfo - O objeto de informações para o serviço de aplicativo.