Sprache

TelephonyManager.RequestNetworkScan Methode

Definition

Überlädt

RequestNetworkScan(Int32, NetworkScanRequest, IExecutor, TelephonyScanManager+NetworkScanCallback)

Fordern Sie einen Netzwerkscan an.

[Android.Runtime.Register("requestNetworkScan", "(ILandroid/telephony/NetworkScanRequest;Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyScanManager$NetworkScanCallback;)Landroid/telephony/NetworkScan;", "GetRequestNetworkScan_ILandroid_telephony_NetworkScanRequest_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyScanManager_NetworkScanCallback_Handler", ApiSince=33)]
public virtual Android.Telephony.NetworkScan? RequestNetworkScan(int includeLocationData, Android.Telephony.NetworkScanRequest request, Java.Util.Concurrent.IExecutor executor, Android.Telephony.TelephonyScanManager.NetworkScanCallback callback);
[<Android.Runtime.Register("requestNetworkScan", "(ILandroid/telephony/NetworkScanRequest;Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyScanManager$NetworkScanCallback;)Landroid/telephony/NetworkScan;", "GetRequestNetworkScan_ILandroid_telephony_NetworkScanRequest_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyScanManager_NetworkScanCallback_Handler", ApiSince=33)>]
abstract member RequestNetworkScan : int * Android.Telephony.NetworkScanRequest * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyScanManager.NetworkScanCallback -> Android.Telephony.NetworkScan
override this.RequestNetworkScan : int * Android.Telephony.NetworkScanRequest * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyScanManager.NetworkScanCallback -> Android.Telephony.NetworkScan

Parameter

includeLocationData
Int32

Gibt an, ob der Anrufer standortbezogene Informationen empfangen möchte. Wenn dieser Parameter auf INCLUDE_LOCATION_DATA_FINE festgelegt ist, wird die Anwendung auf Manifest.permission.ACCESS_FINE_LOCATION Berechtigung überprüft und verfügbare Standortinformationen, die während der Netzwerküberprüfung empfangen werden, an den Aufrufer gesendet. Der Wert ist einer der folgenden: INCLUDE_LOCATION_DATA_NONE INCLUDE_LOCATION_DATA_COARSE INCLUDE_LOCATION_DATA_FINE

request
NetworkScanRequest

Enthält alle RAT mit Bändern/Kanälen, die gescannt werden müssen. Dieser Wert darf nicht NULL sein.

executor
IExecutor

Der Executor, über den der Rückruf aufgerufen werden soll. Da die Scananforderung möglicherweise mehrere Rückrufe auslöst und sie in derselben Reihenfolge aufgerufen werden müssen, wie sie von der Plattform empfangen werden, sollte der Benutzer einen Executor bereitstellen, der Aufgaben einzeln in serieller Reihenfolge ausführt. Dieser Wert darf nicht NULL sein.

callback
TelephonyScanManager.NetworkScanCallback

Gibt Ergebnisse oder Fehler des Netzwerkscans zurück. Dieser Wert darf nicht NULL sein.

Gibt zurück

Ein NetworkScan-Obj, das einen Rückruf enthält, der zum Beenden des Scans verwendet werden kann. Dieser Wert kann null sein.

Attribute

Hinweise

Fordern Sie einen Netzwerkscan an. Diese Methode ist asynchron, sodass die Ergebnisse des Netzwerkscans durch Rückruf zurückgegeben werden. Der zurückgegebene NetworkScan enthält eine Rückrufmethode, mit der der Scan beendet werden kann. Erfordert Die Berechtigung: MODIFY_PHONE_STATE oder dass die aufrufende App Netzbetreiberberechtigungen hat (siehe hasCarrierPrivileges() und Manifest.permission.ACCESS_FINE_LOCATION, wenn includeLocationData auf INCLUDE_LOCATION_DATA_FINE festgelegt ist. Wenn der systemweite Standortwechsel deaktiviert ist, rufen Apps diese API möglicherweise weiterhin mit den folgenden Einschränkungen auf: Die App muss die android.permission.NETWORK_SCAN Berechtigung enthalten. Die App darf keine bestimmten Bänder oder Kanäle zum Scannen bereitstellen. Die App darf nur MCC/MNC-Paare angeben, die einer SIM-Karte im Gerät zugeordnet sind. Zurückgegebene Ergebnisse enthalten keine aussagekräftigen Informationen außer Signalstärke und MCC/MNC-Informationen.. Erfordert Manifest.permission.MODIFY_PHONE_STATE Erfordert das Feature "PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS", das mithilfe von PackageManager.hasSystemFeature(String) erkannt werden kann.

Android-Referenz für android.telephony.TelephonyManager.requestNetworkScan.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

RequestNetworkScan(NetworkScanRequest, IExecutor, TelephonyScanManager+NetworkScanCallback)

Fordern Sie einen Netzwerkscan an.

[Android.Runtime.Register("requestNetworkScan", "(Landroid/telephony/NetworkScanRequest;Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyScanManager$NetworkScanCallback;)Landroid/telephony/NetworkScan;", "GetRequestNetworkScan_Landroid_telephony_NetworkScanRequest_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyScanManager_NetworkScanCallback_Handler", ApiSince=28)]
public virtual Android.Telephony.NetworkScan? RequestNetworkScan(Android.Telephony.NetworkScanRequest? request, Java.Util.Concurrent.IExecutor? executor, Android.Telephony.TelephonyScanManager.NetworkScanCallback? callback);
[<Android.Runtime.Register("requestNetworkScan", "(Landroid/telephony/NetworkScanRequest;Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyScanManager$NetworkScanCallback;)Landroid/telephony/NetworkScan;", "GetRequestNetworkScan_Landroid_telephony_NetworkScanRequest_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyScanManager_NetworkScanCallback_Handler", ApiSince=28)>]
abstract member RequestNetworkScan : Android.Telephony.NetworkScanRequest * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyScanManager.NetworkScanCallback -> Android.Telephony.NetworkScan
override this.RequestNetworkScan : Android.Telephony.NetworkScanRequest * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyScanManager.NetworkScanCallback -> Android.Telephony.NetworkScan

Parameter

request
NetworkScanRequest

Enthält alle RAT mit Bändern/Kanälen, die gescannt werden müssen.

executor
IExecutor

Der Executor, über den der Rückruf aufgerufen werden soll. Da die Scananforderung möglicherweise mehrere Rückrufe auslöst und sie in derselben Reihenfolge aufgerufen werden müssen, wie sie von der Plattform empfangen werden, sollte der Benutzer einen Executor bereitstellen, der Aufgaben einzeln in serieller Reihenfolge ausführt.

callback
TelephonyScanManager.NetworkScanCallback

Gibt Ergebnisse oder Fehler des Netzwerkscans zurück.

Gibt zurück

Ein NetworkScan-Obj, das einen Rückruf enthält, der zum Beenden des Scans verwendet werden kann.

Attribute

Hinweise

Fordern Sie einen Netzwerkscan an. Diese Methode ist asynchron, sodass die Ergebnisse des Netzwerkscans durch Rückruf zurückgegeben werden. Der zurückgegebene NetworkScan enthält eine Rückrufmethode, mit der der Scan beendet werden kann. Erfordert Die Berechtigung: MODIFY_PHONE_STATE oder dass die aufrufende App Netzbetreiberberechtigungen hat (siehe hasCarrierPrivileges() und Manifest.permission.ACCESS_FINE_LOCATION. Wenn der systemweite Standortwechsel deaktiviert ist, rufen Apps diese API möglicherweise weiterhin mit den folgenden Einschränkungen auf: Die App muss die android.permission.NETWORK_SCAN Berechtigung enthalten. Die App darf keine bestimmten Bänder oder Kanäle zum Scannen bereitstellen. Die App darf nur MCC/MNC-Paare angeben, die einer SIM-Karte im Gerät zugeordnet sind. Zurückgegebene Ergebnisse enthalten keine aussagekräftigen Informationen außer Signalstärke und MCC/MNC-Informationen.. Erfordert Manifest.permission.MODIFY_PHONE_STATE und Manifest.permission.ACCESS_FINE_LOCATION Erfordert das Feature "PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS", das mithilfe von PackageManager.hasSystemFeature(String) erkannt werden kann.

Android-Referenz für android.telephony.TelephonyManager.requestNetworkScan.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: