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

Definición

Espacio de nombres:: Android.Nfc

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Establece un mensaje NDEF estático que se va a enviar mediante 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

Mensaje NDEF estático que se va a insertar a través de NFC o null para borrar el proveedor de mensajes estáticos.

activity: Activity

Actividad que no es NULL para la que se insertará el mensaje NDEF.

activities: Activity[]

Matriz que no es NULL de actividades adicionales que no son NULL. Pase una matriz vacía si no hay actividades adicionales. Registre una actividad cada vez desde el método de esa OnCreate actividad.

Atributos: RegisterAttribute

Excepciones

UnsupportedOperationException

El dispositivo no admite NFC.

IllegalStateException

La actividad especificada ya se ha destruido.

NullPointerException

En versiones de Android donde Android Beam es funcional, activity, activitieso un elemento de activities es null.

Comentarios

Android Beam estaba en desuso en el nivel de API 29. En los dispositivos que admiten Android Beam, permanece funcional a través del nivel de API 33. A partir del nivel de API 34, Android Beam se quita y las llamadas a este método no tienen ningún efecto.

El mensaje está disponible solo para la inserción de NDEF mientras se reanuda una actividad especificada. Llame a este método antes Activity.OnDestroyde , preferiblemente desde Activity.OnCreate. No realiza el trabajo de E/S o bloqueo y es seguro llamar desde el subproceso principal.

La actividad reanudada solo puede insertar un mensaje NDEF. Si también se establece una devolución de llamada de mensaje con SetNdefPushMessageCallback, la devolución de llamada tiene prioridad. Pasar null borra el proveedor de mensajes estáticos; una devolución de llamada registrada continúa suministrando el mensaje NDEF.

Use SetNdefPushMessageCallback cuando el mensaje se debe generar dinámicamente. No pase una actividad que ya haya alcanzado Activity.OnDestroy.

Requiere el permiso android.Manifest.permission#NFC.

Documentación de código código abierto android Project código abierto de Android para android.nfc.NfcAdapter.setNdefPushMessage.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a