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 が含まれています。 この値は null にすることはできません。
- executor
- IExecutor
コールバックを呼び出す必要がある Executor。 スキャン要求は複数のコールバックをトリガーする可能性があり、プラットフォームが受信したのと同じ順序で呼び出す必要があるため、ユーザーは、一度に 1 つずつ順番にタスクを実行する Executor を提供する必要があります。 この値は null にすることはできません。
ネットワーク スキャンの結果またはエラーを返します。 この値は null にすることはできません。
返品
スキャンを停止するために使用できるコールバックを含む 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.telephony.TelephonyManager.requestNetworkScanの Android リファレンス。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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
コールバックを呼び出す必要がある Executor。 スキャン要求は複数のコールバックをトリガーする可能性があり、プラットフォームが受信したのと同じ順序で呼び出す必要があるため、ユーザーは、一度に 1 つずつ順番にタスクを実行する Executor を提供する必要があります。
ネットワーク スキャンの結果またはエラーを返します。
返品
スキャンを停止するために使用できるコールバックを含む 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.telephony.TelephonyManager.requestNetworkScanの Android リファレンス。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。