Создание описания устройства

Описание устройства на основе UPnP — это XML-документ, описывающий свойства устройства и иерархию вложенных устройств в нем. Схема описания устройств на основе UPnP, известная как язык шаблона UPnP (UTL) для устройств, определяется в архитектуре устройства UPnP. Описания устройств содержат ссылки на описания услуг. Схема описаний служб и UTL для служб также определена в спецификации "Архитектура устройств UPnP".

Разработчик устройства должен предоставлять описания устройств и служб для устройства.

Элементы описания устройства, которые должен предоставить разработчик размещенного устройства, совпадают с элементами, определенными в спецификации "Архитектура устройств UPnP" со следующими исключениями:

• Элементы controlURL и eventSubURL являются обязательными и должны быть пустыми. Хост устройства заполняет значения для этих полей при публикации и объявлении устройства.
• Элемент UDN должен содержать идентификатор, уникальный для документа описания устройства (т. е. он не должен быть глобально уникальным). Этот идентификатор используется для поиска UDN, который сгенерирован узлом устройства.
• Элементы SCPDURL не должны содержать URL-адреса на описания служб. Вместо этого они должны содержать имя файла описания службы. Файл описания службы должен находиться в каталоге ресурсов. Расположение этого каталога должно быть предоставлено узлу устройства во время регистрации, например с помощью программы установки. Этот путь и все пути, находящиеся ниже, являются относительными относительно зарегистрированного пути.
• Элемент URL внутри элемента значка не должен содержать адреса URL на иконки устройств. Вместо этого они должны содержать имя файла значка. При наличии файл значка должен находиться в каталоге ресурсов. Этот путь и все пути ниже являются относительными путями относительно зарегистрированного пути.
• Элемент URLBase не должен присутствовать.

Заметка

Все URL-адреса, созданные узлом устройства, являются относительными URL-адресами. URL-адреса относятся к расположению документа описания устройства, который отправляется в первоначальном объявлении устройства.

 

Важный

Не добавляйте примечания в документ описания устройства, так как это может привести к сбоям регистрации, когда узел устройства Universal Plug and Play пытается проанализировать документ.

 

Ограничения длины строки

Следующие длины строк используются в API узла устройства с технологией UPnP:

• deviceType – 64 байт
• friendlyName – 64 байт
• производителя – 64 байта
• описание модели – 128 байт
• имя модели – 32 байта
• modelNumber – 32 байта
• serialNumber – 64 байта
• – 12 байт
• serviceType – 64 байт
• serviceId – 64 байта