TelephonyManager.RequestNetworkScan 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
RequestNetworkScan(Int32, NetworkScanRequest, IExecutor, TelephonyScanManager+NetworkScanCallback)
請求網路掃描。
[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參數
- includeLocationData
- Int32
指定來電者是否希望接收與位置相關的資訊。 若此參數設為 INCLUDE_LOCATION_DATA_FINE，應用程式將被檢查Manifest.permission.ACCESS_FINE_LOCATION權限，並在網路掃描期間收到的可用位置資訊會傳送給呼叫者。 價值屬於以下之一：INCLUDE_LOCATION_DATA_NONE INCLUDE_LOCATION_DATA_COARSE INCLUDE_LOCATION_DATA_FINE
- request
- NetworkScanRequest
包含所有需要掃描的頻段/通道 RAT。 這個值不可能為零值。
- executor
- IExecutor
應透過執行者來調用回調。 由於掃描請求可能會觸發多次回調，且必須依照平台接收的順序呼叫，使用者應提供執行器，讓它依序列順序逐項執行任務。 這個值不可能為零值。
回傳網路掃描結果或錯誤。 這個值不可能為零值。
傳回
一個包含回調的 NetworkScan obj，可用來停止掃描。 這個值可能是 Null。
- 屬性
備註
請求網路掃描。 此方法為非同步，因此網路掃描結果會透過回調回傳。 回傳的 NetworkScan 會包含一個回調方法，可用來停止掃描。 需要權限：MODIFY_PHONE_STATE或該呼叫應用程式擁有運營商權限（參見 hasCarrierPrivileges（） ），且若 includeLocationData 設為 INCLUDE_LOCATION_DATA_FINE，則需Manifest.permission.ACCESS_FINE_LOCATION。 如果系統範圍的定位切換關閉，應用程式仍可呼叫此 API，但有以下限制：應用程式必須持有 android.permission.NETWORK_SCAN 權限。 應用程式不得提供任何特定頻段或頻道可供掃描。 應用程式只需指定與裝置中 SIM 卡相關的 MCC/MNC 配對。 回傳的結果除了訊號強度和多重中心/跨線條（MCC/MNC）資訊外，沒有其他有意義的資訊。 需要 Manifest.permission.MODIFY_PHONE_STATE 需要 PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS 功能，可透過 PackageManager.hasSystemFeature（String） 偵測。
Android 參考資料。android.telephony.TelephonyManager.requestNetworkScan
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
RequestNetworkScan(NetworkScanRequest, IExecutor, TelephonyScanManager+NetworkScanCallback)
請求網路掃描。
[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參數
- request
- NetworkScanRequest
包含所有需要掃描的頻段/通道 RAT。
- executor
- IExecutor
應透過執行者來調用回調。 由於掃描請求可能會觸發多次回調，且必須依照平台接收的順序呼叫，使用者應提供執行器，讓它依序列順序逐項執行任務。
回傳網路掃描結果或錯誤。
傳回
一個包含回調的 NetworkScan obj，可用來停止掃描。
- 屬性
備註
請求網路掃描。 此方法為非同步，因此網路掃描結果會透過回調回傳。 回傳的 NetworkScan 會包含一個回調方法，可用來停止掃描。 需要權限：MODIFY_PHONE_STATE或該呼叫應用程式擁有運營商權限（參見 hasCarrierPrivileges（） ）及 Manifest.permission.ACCESS_FINE_LOCATION。 如果系統範圍的定位切換關閉，應用程式仍可呼叫此 API，但有以下限制：應用程式必須持有 android.permission.NETWORK_SCAN 權限。 應用程式不得提供任何特定頻段或頻道可供掃描。 應用程式只需指定與裝置中 SIM 卡相關的 MCC/MNC 配對。 回傳的結果除了訊號強度和多重中心/跨線條（MCC/MNC）資訊外，沒有其他有意義的資訊。 需要 Manifest.permission.MODIFY_PHONE_STATE 和 Manifest.permission.ACCESS_FINE_LOCATION 需要 PackageManager#FEATURE_TELEPHONY_RADIO_ACCESS 功能，可透過 PackageManager.hasSystemFeature（String） 偵測。
Android 參考資料。android.telephony.TelephonyManager.requestNetworkScan
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。