Apparaatprofielen — aanpassing aan elk apparaat

Echte UPnP-hardware is inconsistent over wat het accepteert: de ene streamer wil 24-bit FLAC, een andere speelt alleen 16-bit PCM, een derde liegt over welke codecs het ondersteunt. Een apparaatprofiel is hoe je de plugin de limieten en eigenaardigheden van een apparaat leert.

Hoe een profiel wordt gekozen. Elk apparaat identificeert zichzelf met een User-Agent string wanneer het verbinding maakt. Een profiel zegt "pas mij toe wanneer de user-agent dit fragment bevat." Wanneer een apparaat verbinding maakt, vindt de plugin het overeenkomende profiel; als er geen overeenkomt, is een ingebouwd Generiek Apparaat profiel de terugval. Je kunt meerdere fragmenten scheiden met | (bijvoorbeeld Linn|ChorusDS|BubbleDS) zodat één profiel een familie van gerelateerde apparaten dekt.

Wat een profiel regelt. De limieten die een apparaat niet kan overschrijden — maximale afbeeldingsgrootte voor albumhoezen, toegestaan sample-rate bereik, maximale bitdiepte, alleen-stereo downmixing — plus, wanneer een track wel moet worden geconverteerd, naar welk uitvoerformaat en sample rate te converteren. Een aparte groep "probleemapparaat" schakelaars omzeilt specifieke hardwarefouten (raw-PCM-afhandeling, bytevolgorde, de HTTP content-length header). Deze bestaan omdat UPnP-conformiteit in de praktijk gebrekkig is; de meeste mensen raken ze nooit aan.

Wanneer een profiel aan te passen. Alleen wanneer een specifiek apparaat zich misdraagt. Standaard dekt het Generieke profiel, plus de per-apparaat standaardinstellingen die voor gangbare hardware worden geleverd, de meeste gevallen. Om de user-agent van een apparaat te vinden zodat je het kunt targeten, schakel debug logging in (zie Diagnostiek), speel iets af vanaf het apparaat en lees de useragent= regel in het logboek.

De meest ingrijpende schakelaar van het profiel — forceer native stream — gaat helemaal niet over limieten; het beslist of iets van het bovenstaande van toepassing is. Dat is het volgende concept.

Instellingen

Besturing	Wat het doet
Naam	De weergavenaam van het profiel.
Van toepassing wanneer de user-agent bevat	De user-agent fragment(en) die een apparaat moet bevatten om overeen te komen met dit profiel; scheid alternatieven met |. Niet-overeenkomende apparaten vallen terug op het Generieke profiel.
Maximale afbeeldingsgrootte	Maximale pixelgrootte van albumhoezen die naar dit apparaat wordt verzonden (160 px is de DLNA-standaard; groter wordt niet universeel ondersteund).
Uitvoer-samplefrequentie / tot	Het sample-rate bereik dat het apparaat accepteert; bronnen daarbuiten worden geconverteerd (forceert transcodering).
Kanalen / alleen stereo	Downmix multi-kanaals naar stereo voor apparaten die slechts twee kanalen ondersteunen.
Maximale bitdiepte	Hoogste bitdiepte die het apparaat accepteert; diepere bronnen worden geconverteerd.
Uitvoerformaat	Wanneer transcodering nodig is, het formaat waarnaar moet worden geconverteerd (PCM, FLAC, MP3, AAC, Ogg).
Uitvoer-samplefrequentie	De sample rate die moet worden gebruikt bij transcodering; "hetzelfde als bron" behoudt het origineel.
Gebruik geen RAW PCM	Verpakt PCM in een WAV-container in plaats van ruwe L16/L24 te verzenden. Voor apparaten die ruwe PCM verminken (sommige Marantz).
Forceer little endian voor PCM-streams	Verzendt PCM little-endian in plaats van de big-endian van de specificatie. Verhelpt ruisweergave op apparaten die little-endian verwachten.
Inhoudslengte	Hoe de HTTP Content-Length header moet worden gevuld: Standaard (correcte waarde), Geen (weglaten), Alleen PCM, of Vast (een sentinel "enorme" waarde). Voor apparaten die de header verkeerd afhandelen.