Erstellen einer Gerätebeschreibung

Eine UPnP-basierte Gerätebeschreibung ist ein XML-Dokument, das die Eigenschaften eines Geräts und die Hierarchie geschachtelter Geräte darin beschreibt. Das Schema für UPnP-basierte Gerätebeschreibungen, die als UPnP-Vorlagensprache (UTL) für Geräte bezeichnet werden, wird in der UPnP-Gerätearchitektur definiert. Gerätebeschreibungen enthalten Links zu Dienstbeschreibungen. Das Schema für Dienstbeschreibungen und die UTL für Dienste sind auch in der Spezifikation "UPnP Device Architecture" definiert.

Der Entwickler eines Geräts muss Geräte- und Dienstbeschreibungen für das Gerät bereitstellen.

Die Elemente einer Gerätebeschreibung, die der Entwickler eines gehosteten Geräts bereitstellen muss, sind mit den folgenden Ausnahmen mit den in der Spezifikation "UPnP-Gerätearchitektur" definierten Elementen identisch:

• Die elemente controlURL und eventSubURL sind erforderlich und müssen leer sein. Der Gerätehost füllt Werte für diese Felder aus, wenn das Gerät veröffentlicht und angekündigt wird.
• Das UDN-Element muss einen Bezeichner enthalten, der für das Gerätebeschreibungsdokument eindeutig ist (d. a. es muss nicht global eindeutig sein). Dieser Bezeichner wird verwendet, um den vom Gerätehost generierten UDN nachzuschlagen.
• Die SCPDURL-Elemente dürfen keine URLs zu Dienstbeschreibungen enthalten. Stattdessen müssen sie den Namen der Dienstbeschreibungsdatei enthalten. Die Dienstbeschreibungsdatei muss sich im Ressourcenverzeichnis befinden. Der Speicherort dieses Verzeichnisses muss dem Gerätehost während des Registrierungsprozesses angegeben werden, z. B. mithilfe eines Setupprogramms. Dieser Pfad und alle darunter sind relative Pfade, die auf dem registrierten Pfad basieren.
• Das URL-Element innerhalb des Symbolelements darf keine URLs für Gerätesymbole enthalten. Stattdessen müssen sie den Namen der Symboldatei enthalten. Falls vorhanden, muss sich die Symboldatei im Ressourcenverzeichnis befinden. Dieser Pfad und alle darunter sind relative Pfade, die auf dem registrierten Pfad basieren.
• Das URLBase-Element darf nicht vorhanden sein.

Hinweis

Alle vom Gerätehost generierten URLs sind relative URLs. Die URLs sind relativ zum Speicherort des Gerätebeschreibungsdokuments, das in der anfänglichen Geräteankündigung gesendet wird.

 

Wichtig

Fügen Sie Ihrem Gerätebeschreibungsdokument keine Kommentare hinzu, da dies zu Registrierungsfehlern führen kann, wenn der Universal Plug & Play Device Host versucht, das Dokument zu analysieren.

 

Zeichenfolgenlängenbeschränkungen

Die folgenden Zeichenfolgenlängen werden in der Gerätehost-API mit UPnP-Technologie verwendet:

• deviceType – 64 Bytes
• friendlyName – 64 Bytes
• Hersteller – 64 Bytes
• modelDescription – 128 Bytes
• modelName – 32 Bytes
• modelNumber – 32 Bytes
• serialNumber – 64 Bytes
• UPC – 12 Bytes
• serviceType – 64 Bytes
• serviceId – 64 Bytes