---
title: "Denon discovery — HEOS player ID"
description: "Číta ID prehrávača (pid) prvého prehrávača v systéme Denon HEOS cez HEOS CLI na TCP porte 1255. Jedna premenná; pri importe zadajte IP prehrávača HEOS."
url: "https://taphome.com/sk/compatibility/denon-discovery/"
language: sk
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["tcp","audio","packet-parser","heos-cli","multi-room"]
  questions: ["Ako zistiť ID prehrávača HEOS (pid) reproduktora Denon v TapHome?","Čo číta šablóna Denon discovery v TapHome?","Ako pripojiť prehrávač Denon HEOS k TapHome cez TCP port 1255?","Prečo Denon discovery zobrazuje iba jeden prehrávač, keď je reproduktorov HEOS viac?","Prečo je hodnota Denon player id po importe šablóny prázdna?","Aký je rozdiel medzi šablónami Denon discovery a Denon HEOS?"]
---

# Denon discovery — HEOS player ID

Komunikácia: Packet Parser → TCP

## Návod na integráciu

Denon discovery je malá pomocná šablóna pre produkty Denon HEOS. Zariadenia v sieti nevyhľadáva: pripojí sa k jednému prehrávaču HEOS na IP adrese zadanej pri importe, vyžiada si od HEOS CLI (Command Line Interface) zoznam prehrávačov v systéme HEOS a uloží ID prehrávača (`pid`) **prvého** prehrávača v tomto zozname. Príkazy HEOS CLI pre prehrávače (`heos://player/...`) adresujú prehrávač práve týmto `pid`.

Šablóna obsahuje jeden modul s jedinou premennou **Denon player id**. Nemá ovládanie hlasitosti, stlmenia ani prehrávania.

> [!WARNING]
> Šablóna vždy číta prvú položku zoznamu prehrávačov (`payload[0].pid`). V systéme HEOS s viacerými prehrávačmi zobrazí iba tento jeden `pid` — špecifikácia HEOS CLI poradie zoznamu nedefinuje, takže prvá položka nemusí byť reproduktor, ktorého IP adresa bola zadaná.

Plné ovládanie prehrávača HEOS aj výber prehrávača zo zoznamu podľa indexu (servisné akcie **Get Players** a **Set Player Id**) poskytuje hlavná šablóna [Denon HEOS](https://taphome.com/sk/compatibility/denon-heos/). Denon discovery iba číta `pid`.

## Príprava zariadenia HEOS

HEOS CLI je súčasťou firmvéru HEOS; na zariadení netreba nič zapínať a nie je potrebný žiadny ďalší hardvér. Šablóna je postavená na HEOS CLI v1.17, čo zodpovedá verzii HEOS 2.41.140.

1. Nainštalujte **HEOS App** (Android / iOS) na telefón alebo tablet v tej istej sieti a dokončite úvodné nastavenie zariadenia HEOS, aby bolo pripojené cez Wi-Fi alebo Ethernet. Kým toto nastavenie nie je dokončené, CLI nie je dostupné.
2. Zistite IP adresu zariadenia HEOS — v aplikácii HEOS v **Settings → My Devices → About** alebo v zozname DHCP klientov routera. Produkty HEOS sa v LAN ohlasujú aj cez UPnP SSDP (search target `urn:schemas-denon-com:device:ACT-Denon:1`).
3. Túto adresu si v routeri rezervujte (DHCP rezervácia) alebo nastavte statickú IP, aby sa po obnovení DHCP nezmenila.
4. Overte, že TapHome Core sa dostane k zariadeniu HEOS na **TCP porte 1255** — tá istá LAN alebo smerovaná podsieť a žiadny firewall, ktorý by port blokoval.

Stačí jedno zariadenie HEOS: pripojenie k jednému reproduktoru HEOS sprístupní všetky prehrávače HEOS v sieti, takže `get_players` vráti všetky.

> [!WARNING]
> HEOS CLI nemá vlastné prihlasovanie — akékoľvek zariadenie, ktoré sa dostane na TCP port 1255, môže systému HEOS posielať príkazy. Produkty HEOS držte v dôveryhodnom segmente siete.

## Konfigurácia

Pri importe do rozhrania Packet Parser v aplikácii TapHome zadajte IP adresu zariadenia HEOS do parametra **IP adresa**; port a rámcovanie správ sú v šablóne už nastavené.

| Nastavenie | Hodnota |
|---------|-------|
| Transport | TCP, port 1255 |
| Oddeľovač správ | `\r\n` pre príkazy aj odpovede |
| Spojenie | otvára sa pri každom čítaní, nedrží sa otvorené (`StayConnected` vypnuté) |
| Interval čítania | 15 s |
| Odosielaný príkaz | `heos://player/get_players` |
| Ukladaná hodnota | `payload[0].pid` z odpovede JSON |

Odpoveď na `get_players` je objekt JSON s hlavičkou `heos` (`command`, `result`, `message`) a poľom `payload` s jednou položkou pre každý prehrávač. Každá položka obsahuje `name`, `pid`, `model`, `version` a `network` (`wired` alebo `wifi`), ďalej `lineout` a podľa zariadenia aj `gid` (len ak je prehrávač súčasťou skupiny), `control` a `serial`. Šablóna si ponechá iba `pid` prvej položky.

## Funkcie zariadenia

### Denon player id

**Denon player id** je premenná, ktorá uchováva ID prehrávača HEOS prečítané z prvej položky odpovede `get_players`. Obnovuje sa každých 15 sekúnd, takže pri zmene zoznamu sleduje stav systému HEOS. Šablóna pre túto premennú nemá skript zápisu — je určená iba na čítanie.

Hodnotu možno použiť všade, kde je potrebný HEOS `pid`, napríklad keď sa príkaz `heos://player/*` posiela z iného modulu Packet Parser. Pri použití plnej šablóny [Denon HEOS](https://taphome.com/sk/compatibility/denon-heos/) táto pomocná šablóna nie je potrebná — jej servisné akcie **Get Players** a **Set Player Id** už prehrávače vypíšu a modul naviažu na zvolený prehrávač.

## Riešenie problémov

### Premenná Denon player id zostáva po importe prázdna

Reproduktor HEOS drží CLI v režime spánku a spustí ho až pri prvom prichádzajúcom TCP spojení. Hneď potom CLI ešte nemusí vedieť odpovedať na príkazy pre prehrávače, pretože najprv musí objaviť všetky prehrávače v sieti. Počkajte niekoľko cyklov čítania (každý 15 s). Keďže táto šablóna po každom čítaní spojenie zatvorí, CLI sa medzi čítaniami môže vrátiť do režimu spánku; prvé čítania po dlhšej prestávke preto tiež môžu zostať prázdne.

Ak sa hodnota neobjaví vôbec, skontrolujte, či:

1. IP adresa v module stále patrí zariadeniu HEOS (DHCP rezervácia alebo statická IP).
2. TCP port 1255 je dostupný z TapHome Core — tá istá LAN, žiadny firewall medzi nimi.
3. Zariadenie HEOS je v aplikácii HEOS úplne online.

### Hodnota patrí inému reproduktoru

Šablóna ukladá `pid` prvého prehrávača v zozname, čo nemusí byť reproduktor na zadanej IP adrese. Pri viacerých prehrávačoch HEOS použite hlavnú šablónu [Denon HEOS](https://taphome.com/sk/compatibility/denon-heos/), ktorej servisná akcia **Get Players** zobrazí celý zoznam (meno, `pid`, model) a servisná akcia **Set Player Id** vyberie prehrávač podľa indexu počítaného od 0.

### Pid sa zmenil

HEOS prideľuje hodnoty `pid` prehrávačom v sieti. Ak bol reproduktor obnovený na výrobné nastavenia alebo vymenený, môže dostať nový `pid`; Denon player id zobrazí novú hodnotu pri ďalšom čítaní, ale hodnotu skopírovanú inde treba aktualizovať ručne.

## Dostupné zariadenia 1

Tieto zariadenia sa po importe zobrazia v TapHome.

Denon discovery Modul

Denon player id Premenná

Čítanie (modul)

```taphome
SENDDATA("heos://player/get_players")
```

Listener

```taphome
VAR responseJson := TOSTRING(RECEIVEDBYTES);
Va := PARSEJSON(responseJson,"$.payload[0].pid", 1);
```

**Pripojenie:** Packet Parser → TCP

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii | Predvolené    |
|---------------------|---------------|
| IP adresa           | `192.168.0.1` |

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)