Creazione di una descrizione del dispositivo

Una descrizione del dispositivo basata su UPnP è un documento XML che descrive le proprietà di un dispositivo e la gerarchia dei dispositivi annidati al suo interno. Lo schema per le descrizioni dei dispositivi basate su UPnP, noto come UPnP Template Language (UTL) per i dispositivi, è definito nell'architettura del dispositivo UPnP. Le descrizioni dei dispositivi contengono collegamenti alle descrizioni dei servizi . Lo schema per le descrizioni dei servizi e l'UTL per i servizi sono definiti anche nella specifica "UPnP Device Architecture".

Lo sviluppatore di un dispositivo deve fornire descrizioni dei dispositivi e dei servizi per il dispositivo.

Gli elementi di una descrizione del dispositivo che lo sviluppatore di un dispositivo ospitato deve fornire sono gli stessi definiti nella specifica "Architettura dispositivo UPnP", con le eccezioni seguenti:

• Gli elementi controlURL e eventSubURL sono obbligatori e devono essere vuoti. L'host del dispositivo compila i valori per questi campi quando il dispositivo viene pubblicato e annunciato.
• L'elemento UDN deve contenere un identificatore univoco per il documento di descrizione del dispositivo, ovvero non deve essere univoco a livello globale. Questo identificatore viene usato per cercare l'UDN generato dall'host del dispositivo.
• Gli elementi SCPDURL non devono contenere URL per le descrizioni dei servizi. Devono invece contenere il nome del file di descrizione del servizio. Il file di descrizione del servizio deve trovarsi nella directory della risorsa . Il percorso di questa directory deve essere fornito all'host del dispositivo durante il processo di registrazione, ad esempio usando un programma di installazione. Questo percorso e tutti i percorsi sottostanti sono percorsi relativi, in base al percorso registrato.
• L'elemento url all'interno dell'icona elemento non deve contenere URL alle icone del dispositivo. Devono invece contenere il nome del file icona. Se presente, il file icona deve trovarsi nella directory delle risorse. Questo percorso e tutti i percorsi sottostanti sono percorsi relativi, in base al percorso registrato.
• L'elemento URLBase non deve essere presente.

Nota

Tutti gli URL generati dall'host del dispositivo sono URL relativi. Gli URL sono relativi alla posizione del documento di descrizione del dispositivo, che viene inviato nell'annuncio iniziale del dispositivo.

 

Importante

Non aggiungere commenti al documento di descrizione del dispositivo perché potrebbe causare errori di registrazione quando l'host dispositivo Plug and Play universale tenta di analizzare il documento.

 

Limitazioni relative alla lunghezza delle stringhe

Le lunghezze di stringa seguenti vengono usate nell'API Host dispositivo con la tecnologia UPnP:

• deviceType - 64 byte
• friendlyName - 64 byte
• produttore - 64 byte
• modelDescription - 128 byte
• modelName - 32 byte
• modelNumber - 32 byte
• serialNumber - 64 byte
• UPC - 12 byte
• serviceType - 64 byte
• serviceId - 64 byte