Compartir a través de

Crear una descripción del dispositivo

  • Artículo

Una descripción de dispositivo basada en UPnP es un documento XML que describe las propiedades de un dispositivo y la jerarquía de dispositivos anidados dentro de él. El esquema de descripciones de dispositivos basados en UPnP, conocido como lenguaje de plantilla UPnP (UTL) para dispositivos, se define en la arquitectura del dispositivo UPnP. Las descripciones del dispositivo contienen vínculos a descripciones del servicio. El esquema de las descripciones del servicio y el UTL para los servicios también se definen en la especificación "UPnP Device Architecture".

El desarrollador de un dispositivo debe proporcionar descripciones de dispositivo y servicio para el dispositivo.

Los elementos de una descripción del dispositivo que el desarrollador de un dispositivo hospedado debe proporcionar son los mismos que los definidos en la especificación "UPnP Device Architecture", con las siguientes excepciones:

  • Se requieren los elementos controlURL y eventSubURL y deben estar vacíos. El host del dispositivo rellena los valores de estos campos cuando se publica y anuncia el dispositivo.
  • El elemento UDN debe contener un identificador que sea único para el documento de descripción del dispositivo (es decir, no es necesario que sea único globalmente). Este identificador se usa para buscar el UDN generado por el host del dispositivo.
  • Los elementos SCPDURL no deben contener direcciones URL para las descripciones del servicio. En su lugar, deben contener el nombre del archivo de descripción del servicio. El archivo de descripción del servicio debe encontrarse en el directorio de recursos. La ubicación de este directorio debe proporcionarse al host del dispositivo durante el proceso de registro, como el uso de un programa de instalación. Esta ruta de acceso y todas las siguientes son rutas de acceso relativas, en función de la ruta de acceso registrada.
  • El elemento url del elemento icon no debe contener direcciones URL para los iconos del dispositivo. En su lugar, deben contener el nombre del archivo de icono. Si está presente, el archivo de icono debe encontrarse en el directorio de recursos. Esta ruta de acceso y todas las siguientes son rutas de acceso relativas, en función de la ruta de acceso registrada.
  • El elemento URLBase no debe estar presente.

Nota

Todas las direcciones URL generadas por el host del dispositivo son direcciones URL relativas. Las direcciones URL son relativas a la ubicación del documento de descripción del dispositivo, que se envía en el anuncio inicial del dispositivo.

 

Importante

No agregue comentarios al documento de descripción del dispositivo, ya que puede provocar errores de registro cuando el host de dispositivo universal Plug and Play intenta analizar el documento.

 

Limitaciones de longitud de cadena

Las siguientes longitudes de cadena se usan en la API de host de dispositivo con tecnología UPnP:

  • deviceType : 64 bytes
  • friendlyName : 64 bytes
  • fabricante : 64 bytes
  • modelDescription : 128 bytes
  • modelName : 32 bytes
  • modelNumber : 32 bytes
  • serialNumber : 64 bytes
  • CPU : 12 bytes
  • serviceType : 64 bytes
  • serviceId : 64 bytes