NfcAdapter.SetNdefPushMessageCallback 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 una devolución de llamada que genera dinámicamente mensajes NDEF para enviar mediante Android Beam.

[Android.Runtime.Register("setNdefPushMessageCallback", "(Landroid/nfc/NfcAdapter$CreateNdefMessageCallback;Landroid/app/Activity;[Landroid/app/Activity;)V", "")]
public void SetNdefPushMessageCallback(Android.Nfc.NfcAdapter.ICreateNdefMessageCallback? callback, Android.App.Activity? activity, params Android.App.Activity[]? activities);

[<Android.Runtime.Register("setNdefPushMessageCallback", "(Landroid/nfc/NfcAdapter$CreateNdefMessageCallback;Landroid/app/Activity;[Landroid/app/Activity;)V", "")>]
member this.SetNdefPushMessageCallback : Android.Nfc.NfcAdapter.ICreateNdefMessageCallback * Android.App.Activity * Android.App.Activity[] -> unit

Parámetros

callback: NfcAdapter.ICreateNdefMessageCallback

Devolución de llamada que crea el mensaje NDEF o null para borrar el proveedor de devolución de llamada.

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.

La devolución de llamada solo se puede ejecutar 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 un mensaje estático con SetNdefPushMessage, esta devolución de llamada tiene prioridad. Pasar null borra el proveedor de devolución de llamada; se sigue usando un mensaje estático registrado.

Use SetNdefPushMessage cuando no sea necesario cambiar el mensaje. 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.setNdefPushMessageCallback.

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