Language

NfcAdapter.SetBeamPushUris(Uri[], Activity) メソッド

定義

Android Beam (TM) を使用して送信する 1 つ以上の Uriを設定します。

[Android.Runtime.Register("setBeamPushUris", "([Landroid/net/Uri;Landroid/app/Activity;)V", "")]
public void SetBeamPushUris(Android.Net.Uri[]? uris, Android.App.Activity? activity);
[<Android.Runtime.Register("setBeamPushUris", "([Landroid/net/Uri;Landroid/app/Activity;)V", "")>]
member this.SetBeamPushUris : Android.Net.Uri[] * Android.App.Activity -> unit

パラメーター

uris
Uri[]

Android ビームをプッシュする URI の配列

activity
Activity

URI がプッシュされるアクティビティ

属性

注釈

Android Beam (TM) を使用して送信する 1 つ以上の Uriを設定します。 指定するすべての URI には、スキーム 'file' またはスキーム 'content' が必要です。

この方法で提供されるデータの場合、Android ビームは、高速転送速度を実現するために、Bluetoothなどの代替トランスポートに切り替えようとします。 したがって、この方法は、画像や曲などの大きなファイルを転送するのに非常に適しています。

受信側は、各 URI の内容をファイルに格納し、アクションがandroid.content.Intent#ACTION_VIEWされたandroid.content.Intentでファイルを開く通知をユーザーに提示します。 複数の URI が送信された場合、 android.content.Intent は格納されているファイルの最初の URI を参照します。

このメソッドは、 Activity#onDestroy前にいつでも呼び出されますが、URI は、指定されたアクティビティが再開 (フォアグラウンド) 状態の場合にのみ Android Beam で使用できます。 アクティビティの Activity#onCreate 中にこのメソッドを呼び出す方法をお勧めします。以下のサンプル コードを参照してください。 このメソッドは、I/O またはブロック作業をすぐに実行しないため、メイン スレッドで呼び出しても安全です。

#setBeamPushUris と #setBeamPushUrisCallback は、 #setNdefPushMessage と #setNdefPushMessageCallbackの両方よりも優先されます。

#setBeamPushUrisが null Uri 配列を使用して呼び出された場合や、null コールバックを使用して#setBeamPushUrisCallbackが呼び出された場合、Uri プッシュは指定されたアクティビティに対して完全に無効になります。

コード例:

protected void onCreate(Bundle savedInstanceState) {
                super.onCreate(savedInstanceState);
                NfcAdapter nfcAdapter = NfcAdapter.getDefaultAdapter(this);
                if (nfcAdapter == null) return;  // NFC not available on this device
                nfcAdapter.setBeamPushUris(new Uri[] {uri1, uri2}, this);
            }

そして、 アクティビティごとに 1 つの呼び出しのみが必要です。 このパターンに従うと、Android OS は、破棄されたときに Uri と Activity オブジェクトへの参照を自動的に解放します。

アクティビティで URI を動的に指定する場合は、このメソッドを使用するのではなく、 #setBeamPushUrisCallback を使用してコールバックを設定します。

Activity#onDestroyを既に通過しているアクティビティを渡さないでください。 これは、 Activity#onCreate中にこの API を呼び出す場合に保証されます。

このデバイスが Bluetooth や WiFI などの代替トランスポートをサポートしていない場合、このメソッドを呼び出しても何も行われません。

android.Manifest.permission#NFC アクセス許可が必要です。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象