Partager via

Création d’une description d’appareil

  • Article

Une description d’appareil basée sur UPnP est un document XML qui décrit les propriétés d’un appareil et la hiérarchie des appareils imbriqués qu’il contient. Le schéma des descriptions d’appareils basées sur UPnP, appelé UPnP Template Language (UTL) pour les appareils, est défini dans l’architecture des appareils UPnP. Les descriptions des appareils contiennent des liens vers des descriptions de service. Le schéma pour les descriptions de service et la durée de vie des services sont également définis dans la spécification « UPnP Device Architecture ».

Le développeur d’un appareil doit fournir des descriptions d’appareil et de service pour l’appareil.

Les éléments d’une description d’appareil que le développeur d’un appareil hébergé doit fournir sont les mêmes que ceux définis dans la spécification « UPnP Device Architecture », avec les exceptions suivantes :

  • Les éléments controlURL et eventSubURL sont obligatoires et doivent être vides. L’hôte de l’appareil remplit les valeurs de ces champs lorsque l’appareil est publié et annoncé.
  • L’élément UDN doit contenir un identificateur propre au document de description de l’appareil (autrement dit, il n’a pas besoin d’être globalement unique). Cet identificateur est utilisé pour rechercher l’UDN généré par l’hôte de l’appareil.
  • Les éléments SCPDURL ne doivent pas contenir d’URL pour les descriptions de service. Au lieu de cela, ils doivent contenir le nom du fichier de description du service. Le fichier de description du service doit se trouver dans le répertoire de ressources. L’emplacement de ce répertoire doit être fourni à l’hôte de l’appareil pendant le processus d’inscription, par exemple à l’aide d’un programme d’installation. Ce chemin d’accès et tous les chemins en dessous sont des chemins relatifs, basés sur le chemin inscrit.
  • L’élément URL dans l’élément icon ne doit pas contenir d’URL vers des icônes d’appareil. Au lieu de cela, ils doivent contenir le nom du fichier d’icône. S’il est présent, le fichier d’icône doit se trouver dans le répertoire de ressources. Ce chemin d’accès et tous les chemins en dessous sont des chemins relatifs, basés sur le chemin inscrit.
  • L’élément URLBase ne doit pas être présent.

Notes

Toutes les URL générées par l’hôte de l’appareil sont des URL relatives. Les URL sont relatives à l’emplacement du document de description de l’appareil, qui est envoyé dans l’annonce initiale de l’appareil.

 

Important

N’ajoutez pas de commentaires au document de description de votre appareil, car cela peut entraîner des échecs d’inscription lorsque l’hôte d’appareil universal Plug-and-Play tente d’analyser le document.

 

Limitations de longueur de chaîne

Les longueurs de chaîne suivantes sont utilisées dans l’API Hôte d’appareil avec la technologie UPnP :

  • deviceType : 64 octets
  • friendlyName : 64 octets
  • manufacturer : 64 octets
  • modelDescription : 128 octets
  • modelName : 32 octets
  • modelNumber : 32 octets
  • serialNumber : 64 octets
  • UPC : 12 octets
  • serviceType : 64 octets
  • serviceId : 64 octets