SubscriptionManager.GetPhoneNumber メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| GetPhoneNumber(Int32) |
指定 |
| GetPhoneNumber(Int32, Int32) |
指定 |
GetPhoneNumber(Int32)
指定 subIdされた の電話番号を返します。使用できない場合は空の文字列を返します。
[Android.Runtime.Register("getPhoneNumber", "(I)Ljava/lang/String;", "GetGetPhoneNumber_IHandler", ApiSince=33)]
public virtual string GetPhoneNumber (int subscriptionId);[<Android.Runtime.Register("getPhoneNumber", "(I)Ljava/lang/String;", "GetGetPhoneNumber_IHandler", ApiSince=33)>]
abstract member GetPhoneNumber : int -> string
override this.GetPhoneNumber : int -> stringパラメーター
- subscriptionId
- Int32
サブスクリプション ID、または #DEFAULT_SUBSCRIPTION_ID 既定の ID。
戻り値
電話番号、または空の文字列 (使用できない場合)。
- 属性
注釈
指定 subIdされた の電話番号を返します。使用できない場合は空の文字列を返します。
この API は、電話番号を知る必要がある一般的なアプリに適しています。 特定のソースによって提供される電話番号を知る必要がある特定のアプリの場合は、 #getPhoneNumber(int, int) 適切な場合があります。
この API は に基づいて#getPhoneNumber(int, int)構築されていますが、使用可能なソースから次の順序で選択します。 #PHONE_NUMBER_SOURCE_CARRIER>#PHONE_NUMBER_SOURCE_UICC>#PHONE_NUMBER_SOURCE_IMS
この API では、数値の形式は保証されません。形式は、基になるソースやネットワークなどに応じて異なる場合があります。プログラムによる解析は、たとえば、 で一貫した形式 android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)に数値を書式設定した後など、慎重に行う必要があります。
電話番号の可用性と正確性は、基になるソースやネットワークなどによって異なります。セキュリティ関連またはその他の機密性の高いシナリオでこの番号を使用するには、追加の検証が必要です。
の Java ドキュメント android.telephony.SubscriptionManager.getPhoneNumber(int)。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
GetPhoneNumber(Int32, Int32)
指定 subscriptionId した と sourceの電話番号を返します。使用できない場合は空の文字列を返します。
[Android.Runtime.Register("getPhoneNumber", "(II)Ljava/lang/String;", "GetGetPhoneNumber_IIHandler", ApiSince=33)]
public virtual string GetPhoneNumber (int subscriptionId, int source);[<Android.Runtime.Register("getPhoneNumber", "(II)Ljava/lang/String;", "GetGetPhoneNumber_IIHandler", ApiSince=33)>]
abstract member GetPhoneNumber : int * int -> string
override this.GetPhoneNumber : int * int -> stringパラメーター
- subscriptionId
- Int32
サブスクリプション ID、または #DEFAULT_SUBSCRIPTION_ID 既定の ID。
- source
- Int32
PHONE_NUMBER_SOURCE_* 定数の 1 つである電話番号のソース。
戻り値
電話番号、または空の文字列 (使用できない場合)。
- 属性
注釈
指定 subscriptionId した と sourceの電話番号を返します。使用できない場合は空の文字列を返します。
電話番号を知る必要がある一般的なアプリでは、代わりに を使用 #getPhoneNumber(int) する必要があります。 この API は、特定のソースの電話番号を知る必要がある特定のアプリに適している場合があります。 たとえば、通信事業者アプリは、何が起きっているかを正確に把握し、以前に #PHONE_NUMBER_SOURCE_UICC UICC 設定したソース #PHONE_NUMBER_SOURCE_CARRIER carrier の電話番号を更新する必要があるかどうかを決定する必要があります。
この API では、数値の形式がどのような形式であるかは保証されません。形式は、 や ネットワークなどによって source 異なる場合があります。プログラムによる解析は、たとえば、数値を で一貫した形式 android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)に書式設定した後など、慎重に行う必要があります。
1 つのサブスクリプション (通常は 1 つの SIM を意味します) に電話番号が 1 つしかないという前提に注意してください。 複数のソースが相互にバックアップされるため、少なくとも 1 つが役に立つ場合があります。 たとえば、通常は に電話番号 #PHONE_NUMBER_SOURCE_UICC UICCを設定しない通信事業者の場合、ソース #PHONE_NUMBER_SOURCE_IMS IMS から電話番号が提供される場合があります。 または、ソース UICC も IMS も使用できない場合は、通信事業者がソース #PHONE_NUMBER_SOURCE_CARRIER carrier 経由で電話番号を指定することを決定できます。
電話番号の可用性と正確性は、基になるソースやネットワークなどによって異なります。セキュリティ関連またはその他の機密性の高いシナリオでこの番号を使用するには、追加の検証が必要です。
の Java ドキュメント android.telephony.SubscriptionManager.getPhoneNumber(int, int)。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。