NfcAdapter.InvokeBeam(Activity) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Manually invoke Android Beam to share data.
[Android.Runtime.Register("invokeBeam", "(Landroid/app/Activity;)Z", "")]
public bool InvokeBeam (Android.App.Activity? activity);[<Android.Runtime.Register("invokeBeam", "(Landroid/app/Activity;)Z", "")>]
member this.InvokeBeam : Android.App.Activity -> boolParameters
- activity
- Activity
the current foreground Activity that has registered data to share
Returns
whether the Beam animation was successfully invoked
- Attributes
Remarks
Manually invoke Android Beam to share data.
The Android Beam animation is normally only shown when two NFC-capable devices come into range. By calling this method, an Activity can invoke the Beam animation directly even if no other NFC device is in range yet. The Beam animation will then prompt the user to tap another NFC-capable device to complete the data transfer.
The main advantage of using this method is that it avoids the need for the user to tap the screen to complete the transfer, as this method already establishes the direction of the transfer and the consent of the user to share data. Callers are responsible for making sure that the user has consented to sharing data on NFC tap.
Note that to use this method, the passed in Activity must have already set data to share over Beam by using method calls such as #setNdefPushMessageCallback or #setBeamPushUrisCallback.
Java documentation for android.nfc.NfcAdapter.invokeBeam(android.app.Activity).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.