SubscriptionManager.GetPhoneNumber 方法

定义

重载

GetPhoneNumber(Int32)

返回给定 subId的电话号码,如果不可用,则返回空字符串。

GetPhoneNumber(Int32, Int32)

返回给定 subscriptionId 的电话号码, source如果不可用,则返回空字符串。

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)执行。

电话号码的可用性和正确性取决于基础源和网络等。需要进行其他验证才能将此号码用于安全相关或其他敏感方案。

适用于 . 的 android.telephony.SubscriptionManager.getPhoneNumber(int)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

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_* 常量之一。

返回

电话号码或空字符串(如果不可用)。

属性

注解

返回给定 subscriptionId 的电话号码, source如果不可用,则返回空字符串。

需要知道电话号码的常规应用应改用 #getPhoneNumber(int) 。 此 API 可能适合需要从特定源知道电话号码的特定应用。 例如,运营商应用需要确切地知道发生了什么 #PHONE_NUMBER_SOURCE_UICC UICC 情况,并确定是否应更新以前设置的源 #PHONE_NUMBER_SOURCE_CARRIER carrier 电话号码。

API 不保证数字采用的格式:格式可能因网络等而异 source 。编程分析应谨慎进行,例如,在将数字的格式设置为一致的格式 android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)之后。

请注意,假设一个订阅(通常意味着一个 SIM 卡)只有一个电话号码。 多个源相互备份,因此希望至少有一个可用。 例如,对于通常不设置 #PHONE_NUMBER_SOURCE_UICC UICC电话号码的运营商,源 #PHONE_NUMBER_SOURCE_IMS IMS 可能提供电话号码。 或者,如果源 UICC 和 IMS 均不可用,运营商可能会决定通过源 #PHONE_NUMBER_SOURCE_CARRIER carrier 提供电话号码。

电话号码的可用性和正确性取决于基础源和网络等。需要进行其他验证才能将此号码用于安全相关或其他敏感方案。

适用于 . 的 android.telephony.SubscriptionManager.getPhoneNumber(int, int)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于