BluetoothAdapter.StartDiscovery メソッド

定義

名前空間:
Android.Bluetooth
アセンブリ:
Mono.Android.dll

リモート デバイス検出プロセスを開始します。

[Android.Runtime.Register("startDiscovery", "()Z", "")]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")]
public bool StartDiscovery();
[<Android.Runtime.Register("startDiscovery", "()Z", "")>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")>]
member this.StartDiscovery : unit -> bool

返品

Boolean

成功した場合は true、エラーの場合は false

属性
RegisterAttribute RequiresPermissionAttribute

注釈

リモート デバイス検出プロセスを開始します。

検出プロセスには通常、約 12 秒の問い合わせスキャンが行われ、その後に新しい各デバイスのページ スキャンが実行され、Bluetooth名が取得されます。

これは非同期呼び出しであり、すぐに返されます。 #ACTION_DISCOVERY_STARTEDと#ACTION_DISCOVERY_FINISHEDの意図に登録して、検出の開始と完了を正確に判断します。 リモート Bluetooth デバイスが見つかった場合に通知を受け取る BluetoothDevice#ACTION_FOUND に登録します。

デバイス検出は重い手順です。 検出の進行中はリモート Bluetooth デバイスへの新しい接続を試行しないでください。既存の接続では帯域幅が制限され、待機時間が長くなります。 #cancelDiscovery()を使用して、進行中の検出を取り消します。 検出はアクティビティによって管理されるのではなく、システム サービスとして実行されるため、アプリケーションは、検出を直接要求しなかった場合でも常に BluetoothAdapter#cancelDiscovery() を呼び出す必要があります。

デバイス検出では、現在 検出可能な リモート デバイスのみが検出されます (問い合わせスキャンが有効)。 多くのBluetooth デバイスは既定では検出できないため、特別なモードにする必要があります。

Bluetooth状態が #STATE_ONされていない場合、この API は false を返します。 Bluetoothを有効にした後、#STATE_ONで#ACTION_STATE_CHANGEDが更新された値を取得するまで待ちます。

デバイスが現在ボンディングされている場合、この要求はキューに登録され、そのデバイスの結合が完了すると実行されます。 要求が既にキューに登録されている場合、この要求は無視されます。

Javaドキュメント。

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

適用対象