Общие сведения о метаданных службы

Предупреждение об устаревании ПРОГРАММЫ MBAE

Вы можете создать и отправить пакет метаданных службы, чтобы создать интерфейс, который тесно интегрирован с Windows. Когда Windows обнаруживает мобильное широкополосное оборудование, соответствующее пакету метаданных службы оператора, она автоматически загружает метаданные службы и указанное мобильное широкополосное приложение.

Метаданные службы содержат сведения, описывающие службу, в том числе следующие:

• Имя поставщика услуг

• Одна или несколько категорий служб

• Сведения о мобильной широкополосной связи

• Мобильное широкополосное приложение

• Профили мобильной широкополосной связи

• Доверенные сертификаты для подготовки XML

• Элемент DeviceNotificationHandler

• Элемент PrivilegedApplications

Сведения в метаданных используются для настройки аспектов Windows 8, Windows 8.1 и Windows 10 пользовательского интерфейса и обеспечения интеграции с мобильным широкополосным приложением, которое ранее называлось приложением мобильного оператора.

Пакет метаданных службы состоит из нескольких XML-документов, хранящихся в файле .devicemetadata-ms. В каждом документе указываются различные компоненты атрибутов службы. Эти XML-документы предоставляют windows диспетчер подключений с настройками, которые отображаются для пользователя, а также сведения о конфигурации сети.

Справочные сведения о XML-документах в пакете метаданных службы см. в справочнике по схеме пакета метаданных службы.

Содержимое метаданных службы

В следующей сводке описываются некоторые из наиболее интересных полей, которые содержатся и определяются в пакете метаданных службы.

• Идентификаторы оборудования
  Для сети GSM можно отправить пакет метаданных, описывающий диапазоны IMSI или ICCID, с которыми должен соответствовать пакет метаданных службы. Если вы являетесь MVNO, вы можете указать один или несколько диапазонов IMSIs или ИДЕНТИФИКАТОРов SIM ICC, которые вы арендовали у MNO. Для сети CDMA можно отправить пакет с помощью идентификатора поставщика (SID/NID) или имени поставщика. Идентификаторы оборудования соответствуют элементу HardwareID в схеме пакета метаданных службы. Дополнительные сведения о планировании диапазонов идентификации оборудования (HWID) для сценариев MNO и MVNO см. в статье Доставка возможностей для MVNOs

• Номер службы
  Уникальный идентификатор поставщика услуг мобильной широкополосной связи. Этот GUID также используется для идентификации оператора при использовании метаданных подготовки учетной записи. При обновлении пакета метаданных устройства этот GUID должен оставаться прежним. Номер службы соответствует элементу ServiceNumber в схеме пакета метаданных службы.

• Логотип оператора Настраиваемый логотип, отображаемый в Windows диспетчер подключений рядом с вашей записью в сети. (Логотип скрыт, когда пользователь находится в роуминге.) Логотип оператора соответствует элементу ServiceIconFile в схеме пакета метаданных службы. Дополнительные сведения о требованиях к логотипу см. в разделе Требования к значку службы.

  Важно!

  В Windows 10 версии 1709 и более поздних версиях это поле было заменено фирменной символике с помощью COSA. Поля в COSA для фирменной символики описаны в разделе Планирование отправки базы данных COSA/APN на рабочем столе. Если вы используете версии Windows до Windows 10 версии 1709, вы по-прежнему создадите пакет метаданных, как описано в этом разделе. Дополнительные сведения о COSA см. в статье Общие сведения о COSA.

• Мобильное широкополосное приложение
  Приложение устройства UWP, которое автоматически загружается и применяется к компьютеру. Это приложение может предоставлять ключевые возможности, такие как покупка плана, использование данных, справка и поддержка, а также может выделять службы с добавленной стоимостью.

• MB Purchase Profile
  Профиль покупки, используемый для установления ограниченного подключения для приобретения подписки.

  Если вы являетесь оператором GSM, у которого есть только один APN покупки для всех подписчиков, вы можете использовать метаданные службы для их подготовки на компьютере. Если у вас есть несколько APN покупки, следует использовать метаданные подготовки учетной записи, чтобы задать соответствующую точку доступа покупки. Или вы можете ничего не делать и использовать записи, хранящиеся в базе данных APN, для предоставления сведений о подключении APN.

• Мб Интернет-профиль
  Каждая подписка на мобильное широкополосное подключение может иметь один профиль по умолчанию, который используется для подключения к оператору домашней сети. Windows диспетчер подключений использует этот профиль для автоматического подключения к сети.

  Если вы являетесь оператором GSM, который имеет только один интернет-APN для всех подписчиков, вы можете использовать метаданные службы для подготовки компьютера. При наличии нескольких интернет-сетей APN следует использовать метаданные подготовки учетной записи, чтобы задать соответствующую точку доступа в Интернете. Или вы можете ничего не делать и использовать записи, хранящиеся в базе данных APN, для предоставления сведений о подключении APN.

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

• Имя настраиваемого оператора
  Мобильное широкополосное устройство обычно предоставляет имя оператора, которое Windows отображает в windows диспетчер подключений. Это имя можно переопределить, указав пользовательское имя в метаданных. Это имя отображается только в том случае, если пользователь находится в домашней сети, а не в роуминге. Отображаемое имя перемещаемой сети основано на информации, полученной с устройства. Соответствует элементу ServiceProvider в схеме метаданных пакета службы.

  Важно!

  В Windows 10 версии 1709 и более поздних версиях это поле было заменено фирменной символике с помощью COSA. Поля в COSA для фирменной символики описаны в разделе Планирование отправки базы данных COSA/APN на рабочем столе. Если вы используете версии Windows до Windows 10 версии 1709, вы по-прежнему создадите пакет метаданных, как описано в этом разделе. Дополнительные сведения о COSA см. в статье Общие сведения о COSA.

• Обработчик уведомлений устройства
  Как правило, приложение должно запускаться пользователем по крайней мере один раз, прежде чем оно сможет регистрировать рабочие элементы в брокере системных событий. Однако приложениям мобильной широкополосной связи может потребоваться получать важные события, прежде чем пользователь сможет запустить приложение. В метаданных службы можно указать элемент DeviceNotificationHandler , который Windows будет использовать для регистрации некоторых критических событий. Дополнительные сведения о SMS-уведомлениях см. в статье Доставка возможностей для MVNOs.

• Список привилегированных приложений с доступом к интерфейсам с ограниченной мобильной широкополосной связью
  API и интерфейсы мобильной широкополосной связи (включая подготовку учетных записей и SMS) ограничены и доступны только для мобильных широкополосных приложений. Список привилегированных приложений, имеющих доступ к этим привилегированным API, можно указать в пакете метаданных службы в элементе PrivilegedApplications . Привилегированные приложения могут выполнять отладку или тестирование приложений; они не обязательно должны распространяться через Microsoft Store.

Структура пакета метаданных службы

Компоненты пакета метаданных службы хранятся в сжатом cab-файле и должны иметь расширение .devicemetadata-ms. Пакеты метаданных службы используют это расширение файла, так как они используют ту же базовую платформу, что и пакеты метаданных устройства. Перед созданием файла .devicemetadata-ms необходимо сначала создать глобальный уникальный идентификатор (GUID) для пакета метаданных. Затем при создании файла .devicemetadata-ms необходимо использовать следующее соглашение об именовании: <GUID.devicemetadata-ms>.

Примечание Хотя обычное расширение cab-файла .cab, расширение файла пакета метаданных службы должно иметь значение .devicemetadata-ms. Это подчеркивает тот факт, что конечные пользователи не должны распаковывать или изменять эти пакеты.

Существует два типа пакетов метаданных службы: один пакет метаданных службы языкового стандарта и пакет метаданных службы языкового стандарта.

Пакет метаданных службы с одним языковым стандартом

Локализуемые ресурсы в пакете метаданных службы — это имя оператора, отображаемое в Windows диспетчер подключений, и значок службы, который отображается рядом с ним. Если вам не нужно локализовать имя или изменять значок на основе сведений о языковом стандарте с компьютера, создайте один пакет метаданных службы языкового стандарта. Независимо от того, какой языковой стандарт пользователь использует на своем компьютере, он получит имя оператора и значок службы, определенные в пакете метаданных службы с одним языковым стандартом.

Один пакет метаданных службы языкового стандарта должен иметь следующую структуру файлов:

Некоторые рекомендации для одного пакета метаданных языкового стандарта:

• Файл значка может иметь любое имя файла. Однако отдельные XML-документы должны называться PackageInfo.xml, ServiceInfo.xml, WindowsInfo.xmlи SoftwareInfo.xml.

• Имя файла MobileBroadbandInfo.xml определяется в ServiceInfo.xml. Для этого файла следует использовать имена, перечисленные в этом документе.

• Файл .devicemetadata-ms не может содержать "{" или "}" в имени. Идентификатор GUID для каждого файла пакета метаданных должен быть уникальным. При создании нового или измененного пакета метаданных службы необходимо создать новый GUID, даже если изменения незначительны.

• Windows распознает пакеты метаданных службы с расширением devicemetadata-ms.

Структура пакета метаданных службы с несколькими языковыми стандартами

Пакет метаданных службы поддерживает несколько файлов языкового стандарта в одном пакете. Если вы поддерживаете несколько языковых стандартов для службы, можно поместить несколько файлов языкового стандарта в один пакет метаданных службы.

Можно использовать пакет метаданных нескольких локальных служб, если требуется отобразить локализованное имя службы в списке сети Windows диспетчер подключений или другой логотип в Windows диспетчер подключений для сети. Windows отобразит локализованное сетевое имя и логотип на основе предпочитаемого системой языка, который обычно настраивается во время установки Windows. Даже если язык текущего пользователя отличается от предпочитаемого системой языка, значок и имя сети всегда будут отображаться на предпочитаемом системе языке. Если пакет метаданных службы не содержит языковой стандарт, отображается нейтральное описание языка из корня пакета метаданных службы. Для большинства пользователей их язык будет соответствовать предпочитаемой системе языку.

Пакет метаданных службы с несколькими языковыми стандартами должен иметь следующую структуру файлов:

Некоторые рекомендации по использованию пакета метаданных нескольких языковых стандартов:

• Создайте папку с именем языкового стандарта в каждой папке и поместите XML-файл или соответствующий файл в папку имени языкового стандарта.

• На верхнем уровне каждой папки по-прежнему должен быть XML-файл верхнего уровня и соответствующие файлы, например файл значка. Это обеспечивает резервный механизм, если языковой стандарт не включен в пакет метаданных службы.

• Убедитесь, что все необходимые файлы и поля в этих файлах полностью заполнены в каждой создаваемой папке с определенным языковым стандартом. Это дополнение к содержимому на верхнем уровне каждой папки. Например, элемент ServiceNumber в ServiceInfo.xml должен быть заполнен и дублирован в папке верхнего уровня и в каждой создаваемой папке с определенным языковым стандартом. В противном случае это приведет к ошибкам.

• XML-документ SoftwareInformation не поддерживает несколько языковых стандартов, так как вы не можете указать разные SoftwareInfo.xml файлы для каждого языкового стандарта.

Отправка и обслуживание метаданных службы

Дополнительные сведения об отправке пакетов метаданных службы на панель мониторинга Центра разработки для Windows — оборудование см. в руководстве разработчика по созданию метаданных службы.

Важно поддерживать актуальность пакетов метаданных с точки зрения того, как они описаны и какие значения IMSI и ICCID или CDMA Provider Name or SID они соответствуют. Это может потребовать от MNO или MVNO для реализации нового рабочего процесса, который является частью приобретения SIM-карты или устройства для отслеживания новых заказов SIM-карт и MNO или MVNO, которым предоставляются эти ICCID или IMSIs.

Рекомендуется не вносить частые изменения в метаданные службы, заранее резервируя диапазоны ICCID или IMSI (или CDMA SIM-карты или поставщика) для MNO и MVNO, чтобы при приобретении новых sim-карт (или устройств CDMA) они уже учитывались в пакете метаданных службы.

Если вам нужно обновить идентификаторы служб, зарегистрированные на панели мониторинга оборудования Центра разработки для Windows, см. статью Обновления владения идентификаторами служб.

Обновления метаданных автоматически применяются на основе внутренней логики Windows (обычно каждые восемь дней), когда Windows запрашивает WMIS о наличии обновлений метаданных.

Приложение должно работать с предыдущей версией метаданных, на которую оно ссылается, до тех пор, пока последние метаданные не будут применены к системе.

Проектирование пользовательского интерфейса мобильного широкополосного приложения содержит рекомендации по проектированию пользовательского интерфейса для устранения распространенных ошибок, таких как отсутствие или не распознание устройства.