Criando uma descrição do dispositivo

Uma descrição de dispositivo baseada em UPnP é um documento XML que descreve as propriedades de um dispositivo e a hierarquia de dispositivos aninhados dentro dele. O esquema para descrições de dispositivos baseados em UPnP, conhecido como UTL (Linguagem de Modelo UPnP) para dispositivos, é definido na arquitetura do dispositivo UPnP. As descrições do dispositivo contêm links para descrições de serviço. O esquema para descrições de serviço e o UTL para serviços também são definidos na especificação "Arquitetura do Dispositivo UPnP".

O desenvolvedor de um dispositivo deve fornecer descrições de dispositivo e serviço para o dispositivo.

Os elementos de uma descrição do dispositivo que o desenvolvedor de um dispositivo hospedado deve fornecer são os mesmos definidos na especificação "Arquitetura do Dispositivo UPnP", com as seguintes exceções:

• Os elementos controlURL e eventSubURL são necessários e devem estar vazios. O host do dispositivo preenche valores para esses campos quando o dispositivo é publicado e anunciado.
• O elemento UDN deve conter um identificador exclusivo do documento de descrição do dispositivo (ou seja, ele não precisa ser globalmente exclusivo). Esse identificador é usado para pesquisar a UDN gerada pelo host do dispositivo.
• Os elementos SCPDURL não devem conter URLs para descrições de serviço. Em vez disso, eles devem conter o nome do arquivo de descrição do serviço. O arquivo de descrição do serviço deve estar localizado no diretório de recursos. O local desse diretório deve ser fornecido ao host do dispositivo durante o processo de registro, como o uso de um programa de instalação. Esse caminho e todos abaixo dele são caminhos relativos, com base no caminho registrado.
• O elemento url dentro do elemento de ícone não deve conter URLs para ícones de dispositivo. Em vez disso, eles devem conter o nome do arquivo de ícone. Se estiver presente, o arquivo de ícone deverá estar localizado no diretório de recursos. Esse caminho e todos abaixo dele são caminhos relativos, com base no caminho registrado.
• O elemento URLBase não deve estar presente.

Observação

Todas as URLs geradas pelo host do dispositivo são URLs relativas. As URLs são relativas ao local do documento de descrição do dispositivo, que é enviado no comunicado inicial do dispositivo.

 

Importante

Não adicione comentários ao documento de descrição do dispositivo, pois ele pode causar falhas de registro quando o Host de Dispositivo do Plug and Play Universal tenta analisar o documento.

 

Limitações de comprimento da cadeia de caracteres

Os seguintes comprimentos de cadeia de caracteres são usados na API de Host do Dispositivo com a tecnologia UPnP:

• deviceType – 64 bytes
• friendlyName – 64 bytes
• fabricante – 64 bytes
• modelDescription – 128 bytes
• modelName – 32 bytes
• modelNumber – 32 bytes
• serialNumber – 64 bytes
• UPC – 12 bytes
• serviceType – 64 bytes
• serviceId – 64 bytes