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


ESim Класс

Определение

Класс, представляющий внедренную SIM-карту (eSIM или eUICC). ESIM хранит одно или несколько удостоверений (профилей eSIM), принадлежащих одному или нескольким операторам мобильной сети (MНКО). ESIM не является форм-фактором; это способ управления профилями SIM-карты.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

public ref class ESim sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ESim final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ESim final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ESim
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ESim
Public NotInheritable Class ESim
Наследование
Object Platform::Object IInspectable ESim
Атрибуты

Требования к Windows

Семейство устройств
Windows 10, version 1803 (появилось в 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v6.0)
Возможности приложения
Microsoft.eSIMManagement_8wekyb3d8bbwe

Комментарии

Традиционная SIM-карта хранит одно удостоверение, которое модем может использовать для регистрации в сети оператора мобильной сети (MNO) и предоставления услуг сотовой связи (карта обычно распространяется MNO). Но eSIM хранит одно или несколько удостоверений (профилей eSIM), принадлежащих одному или нескольким операторам мобильной связи. ESIM переключает удостоверения, включая и отключая профили eSIM, сохраненные на карта. После включения профиля eSIM появится eSIM и функционирует так, как если бы это была традиционная SIM-карта из MNO, распространяющего профиль. Таким образом, конечный пользователь может легко переключаться между MNOS, не изменяя физические карта.

Процесс установки профиля на eSIM выполняется в нескольких шагах. Конечный пользователь предоставляет код активации, который представляет собой строку, содержащую универсальное расположение ресурса (URL-адрес) сервера распространения профилей, а также некоторые идентифицирующие сведения. Затем устройство с поддержкой eSIM использует данные в коде активации для связи с сервером. Сервер возвращает метаданные для определенного профиля вместе с информацией, которая затем предоставляется пользователю, запрашивающего согласие на скачивание профиля. Получив согласие, устройство с поддержкой eSIM загружает профиль и отправляет двоичный blob-объект профиля в eSIM. Наконец, профиль готов к активации после успешной записи профиля в eSIM. LpaSvc — это служба для обработки всех запросов операций, связанных с eSIM. Для конечных пользователей в разделе Параметры есть страница Управление профилями eSIM, чтобы предоставить пользовательский интерфейс для управления eSIM.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1903 18362 Обнаружить
1903 18362 Discover(String;String)
1903 18362 DiscoverAsync
1903 18362 DiscoverAsync(String;String)

Свойства

AvailableMemoryInBytes

Возвращает доступную память на карта SIM-карты в целых байтах.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

Eid

Возвращает идентификатор eSIM (EID).

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

FirmwareVersion

Возвращает версию встроенного ПО eSIM.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

MobileBroadbandModemDeviceId

Возвращает идентификатор устройства или идентификатор DeviceInformation для сетевого устройства MobileBroadbandModem , которое содержит eSIM.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

Policy

Возвращает политику для eSIM, в отношении того, должен ли eSIM отображаться в локальном пользовательском интерфейсе (LUI) для управления eSIM.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

SlotIndex

Возвращает индекс слота на основе 0 (номер слота), которому соответствует eSim. ESim.SlotIndex соответствует свойству Index соответствующего объекта MobileBroadbandSlotInfo .

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

State

Возвращает состояние eSIM, указывающее наличие и рабочее состояние eSIM.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

Методы

DeleteProfileAsync(String)

Асинхронно удаляет указанный профиль eSIM.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

Discover()

Выполняет операцию обнаружения профиля eSIM, используя адрес SMDS по умолчанию.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

Discover(String, String)

Выполняет операцию обнаружения профиля eSIM для указанного адреса RSP-сервера и соответствующего идентификатора.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

DiscoverAsync()

Асинхронно выполняет операцию обнаружения профиля eSIM, используя адрес SMDS по умолчанию.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

DiscoverAsync(String, String)

Асинхронно выполняет операцию обнаружения профиля eSIM для указанного адреса RSP-сервера и соответствующего идентификатора.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

DownloadProfileMetadataAsync(String)

Асинхронно скачивает метаданные установки для профиля eSIM, соответствующего указанному коду активации.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

GetProfiles()

Возвращает набор профилей, хранящихся в eSIM.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

ResetAsync()

Асинхронно сбрасывает eSIM.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

События

ProfileChanged

Происходит при изменении коллекции профилей eSIM или при изменении свойства одного из профилей в коллекции.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.eSIMManagement_8wekyb3d8bbwe. Дополнительные сведения см. в разделе Пользовательские возможности.

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