Поделиться через

SubscriptionManager.GetPhoneNumber Метод

  • Ссылка

Определение

Пространство имен:
Android.Telephony
Сборка:
Mono.Android.dll

Перегрузки

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

идентификатор подписки или #DEFAULT_SUBSCRIPTION_ID идентификатор по умолчанию.

Возвращаемое значение

String

номер телефона или пустую строку, если она недоступна.

Атрибуты
RegisterAttribute

Комментарии

Возвращает номер телефона для заданного 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).

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

Применяется к

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

идентификатор подписки или #DEFAULT_SUBSCRIPTION_ID идентификатор по умолчанию.

source
Int32

источник номера телефона, одна из констант PHONE_NUMBER_SOURCE_*.

Возвращаемое значение

String

номер телефона или пустую строку, если она недоступна.

Атрибуты
RegisterAttribute

Комментарии

Возвращает номер телефона для заданных 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 может предоставить один из них. Кроме того, оператор может указать номер телефона через источник #PHONE_NUMBER_SOURCE_CARRIER carrier , если ни uicc, ни IMS не доступны.

Доступность и правильность номера телефона зависит от базового источника, сети и т. д. Для использования этого номера в сценариях, связанных с безопасностью или другими конфиденциальными сценариями, требуется дополнительная проверка.

Документация по Java для android.telephony.SubscriptionManager.getPhoneNumber(int, int).

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

Применяется к