BluetoothLeScanner.StartScan メソッド

定義

名前空間:: Android.Bluetooth.LE

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Name	説明
StartScan(ScanCallback)	既定のパラメーター Bluetoothフィルターなしで LE スキャンを開始します。
StartScan(IList<ScanFilter>, ScanSettings, PendingIntent)	`PendingIntent`Bluetooth使用して LE スキャンを開始します。
StartScan(IList<ScanFilter>, ScanSettings, ScanCallback)	LE スキャンBluetooth開始します。

StartScan(ScanCallback)

既定のパラメーター Bluetoothフィルターなしで LE スキャンを開始します。

[Android.Runtime.Register("startScan", "(Landroid/bluetooth/le/ScanCallback;)V", "")]
public void StartScan(Android.Bluetooth.LE.ScanCallback callback);

[<Android.Runtime.Register("startScan", "(Landroid/bluetooth/le/ScanCallback;)V", "")>]
member this.StartScan : Android.Bluetooth.LE.ScanCallback -> unit

パラメーター

callback: ScanCallback

スキャン結果を配信するために使用されるコールバック。

属性: RegisterAttribute

例外

IllegalArgumentException

callbackが null の場合。

注釈

既定のパラメーター Bluetoothフィルターなしで LE スキャンを開始します。スキャン結果は、 callback経由で配信されます。フィルター処理されていないスキャンの場合、画面がオフの状態でスキャンが停止され、電力が節約されます。再び画面がオンになると、スキャンが再開されます。これを回避するには、目的のScanFilterで#startScan(List, ScanSettings, ScanCallback)を使用します。

結果を取得するには、アプリに android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION アクセス許可が必要です。結果を取得するには、Android Q 以降を対象とするアプリに android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION アクセス許可が必要です。

Javaドキュメント。

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

適用対象

StartScan(IList<ScanFilter>, ScanSettings, PendingIntent)

PendingIntentBluetooth使用して LE スキャンを開始します。

[Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/app/PendingIntent;)I", "", ApiSince=26)]
public int StartScan(System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter>? filters, Android.Bluetooth.LE.ScanSettings? settings, Android.App.PendingIntent callbackIntent);

[<Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/app/PendingIntent;)I", "", ApiSince=26)>]
member this.StartScan : System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter> * Android.Bluetooth.LE.ScanSettings * Android.App.PendingIntent -> int

パラメーター

filters: IList<ScanFilter>

正確な BLE デバイスを検索するための ScanFilters の省略可能な一覧。

settings: ScanSettings

スキャンのオプションの設定。

callbackIntent: PendingIntent

結果を配信する PendingIntent。

返品

Int32

成功した場合は 0 を返し、スキャン要求を送信できなかった場合は ScanCallback からエラーコードを返します。

属性: RegisterAttribute

注釈

PendingIntentBluetooth使用して LE スキャンを開始します。スキャン結果は、PendingIntent 経由で配信されます。このスキャン方法は、プロセスが常に実行されているとは限らず、スキャン結果が使用可能になったときに開始する必要がある場合に使用します。

PendingIntent が配信されると、受信側またはアクティビティに渡される意図には、スキャンの結果を示す 1 つ以上の追加 #EXTRA_CALLBACK_TYPE、 #EXTRA_ERROR_CODE 、 #EXTRA_LIST_SCAN_RESULT が含まれます。

Javaドキュメント。

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

適用対象

StartScan(IList<ScanFilter>, ScanSettings, ScanCallback)

LE スキャンBluetooth開始します。

[Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/bluetooth/le/ScanCallback;)V", "")]
public void StartScan(System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter>? filters, Android.Bluetooth.LE.ScanSettings settings, Android.Bluetooth.LE.ScanCallback callback);

[<Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/bluetooth/le/ScanCallback;)V", "")>]
member this.StartScan : System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter> * Android.Bluetooth.LE.ScanSettings * Android.Bluetooth.LE.ScanCallback -> unit

パラメーター

filters: IList<ScanFilter>

ScanFilter正確なBLEデバイスを見つけるためのs。

settings: ScanSettings

スキャンの設定。

callback: ScanCallback

スキャン結果を配信するために使用されるコールバック。

属性: RegisterAttribute

注釈

LE スキャンBluetooth開始します。スキャン結果は、 callback経由で配信されます。フィルター処理されていないスキャンの場合、画面がオフの状態でスキャンが停止され、電力が節約されます。再び画面がオンになると、スキャンが再開されます。これを回避するには、適切な ScanFilterを使用してスキャンをフィルター処理します。

Javaドキュメント。

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

適用対象