NfcAdapter.SetNdefPushMessage(NdefMessage, Activity, Activity[]) Método

Definição

Namespace:: Android.Nfc

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define uma mensagem NDEF estática para enviar usando o Android Beam.

[Android.Runtime.Register("setNdefPushMessage", "(Landroid/nfc/NdefMessage;Landroid/app/Activity;[Landroid/app/Activity;)V", "")]
public void SetNdefPushMessage(Android.Nfc.NdefMessage? message, Android.App.Activity? activity, params Android.App.Activity[]? activities);

[<Android.Runtime.Register("setNdefPushMessage", "(Landroid/nfc/NdefMessage;Landroid/app/Activity;[Landroid/app/Activity;)V", "")>]
member this.SetNdefPushMessage : Android.Nfc.NdefMessage * Android.App.Activity * Android.App.Activity[] -> unit

Parâmetros

message: NdefMessage

A mensagem NDEF estática para enviar por push o NFC ou null limpar o provedor de mensagens estáticas.

activity: Activity

A atividade não nula para a qual a mensagem NDEF será enviada por push.

activities: Activity[]

Uma matriz não nula de atividades adicionais não nulas. Passe uma matriz vazia se não houver atividades adicionais. Registre uma atividade de cada vez do método dessa OnCreate atividade.

Atributos: RegisterAttribute

Exceções

UnsupportedOperationException

O dispositivo não dá suporte a NFC.

IllegalStateException

A atividade especificada já foi destruída.

NullPointerException

Em versões do Android em que o Android Beam está funcional, activityactivitiesou um elemento é activitiesnull.

Comentários

O Android Beam foi preterido no nível 29 da API. Em dispositivos que dão suporte ao Android Beam, ele permanece funcional por meio do nível de API 33. A partir do nível de API 34, o Android Beam é removido e as chamadas para esse método não têm efeito.

A mensagem é disponibilizada para push do NDEF somente enquanto uma atividade especificada é retomada. Chame esse método antes Activity.OnDestroy, de preferência de Activity.OnCreate. Ele não executa E/S ou trabalho de bloqueio e é seguro chamar do thread principal.

Somente uma mensagem NDEF pode ser enviada por push pela atividade retomada. Se um retorno de chamada de mensagem também for definido com SetNdefPushMessageCallbacko retorno de chamada, o retorno de chamada tem prioridade. Passar null limpa o provedor de mensagens estáticas; um retorno de chamada registrado continua a fornecer a mensagem NDEF.

Use SetNdefPushMessageCallback quando a mensagem precisar ser gerada dinamicamente. Não passe uma atividade que já tenha atingido Activity.OnDestroy.

Requer a permissão android.Manifest.permission#NFC.

Documentação de código-fonte do software livre do Android Open Source Project para android.nfc.NfcAdapter.setNdefPushMessage.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a