---
title: "Denon discovery — HEOS player ID"
description: "Citește ID-ul de player HEOS (pid) al primului player din sistemul Denon HEOS prin HEOS CLI pe portul TCP 1255. O variabilă; la import introduceți IP-ul."
url: "https://taphome.com/ro/compatibility/denon-discovery/"
language: ro
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["tcp","audio","packet-parser","heos-cli","multi-room"]
  questions: ["Cum obțin ID-ul de player HEOS (pid) al unei boxe Denon în TapHome?","Ce citește șablonul TapHome Denon discovery?","Cum conectez un player Denon HEOS la TapHome prin portul TCP 1255?","De ce afișează Denon discovery un singur player când există mai multe boxe HEOS?","De ce este goală valoarea Denon player id după importul șablonului?","Care este diferența dintre șabloanele Denon discovery și Denon HEOS?"]
---

# Denon discovery — HEOS player ID

Comunicație: Packet Parser → TCP

## Ghid de integrare

Denon discovery este un mic șablon auxiliar pentru produsele Denon HEOS. Nu caută dispozitive în rețea: se conectează la un singur player HEOS, la adresa IP introdusă la import, cere de la HEOS CLI (Command Line Interface) lista playerelor din sistemul HEOS și memorează ID-ul de player (`pid`) al **primului** player din listă. Comenzile pentru playere ale HEOS CLI (`heos://player/...`) adresează un player prin acest `pid`.

Șablonul conține un singur modul cu o singură variabilă, **Denon player id**. Nu oferă control al volumului, al dezactivării sunetului sau al redării.

> [!WARNING]
> Șablonul citește întotdeauna prima intrare din lista playerelor (`payload[0].pid`). Într-un sistem HEOS cu mai multe playere afișează doar acest `pid` — specificația HEOS CLI nu definește ordinea listei, așa că prima intrare nu este neapărat boxa a cărei adresă IP a fost introdusă.

Controlul complet al unui player HEOS și selectarea unui player din listă după index (acțiunile de service **Get Players** și **Set Player Id**) sunt oferite de șablonul principal [Denon HEOS](https://taphome.com/ro/compatibility/denon-heos/). Denon discovery doar citește `pid`-ul.

## Pregătirea dispozitivului HEOS

HEOS CLI face parte din firmware-ul HEOS; pe dispozitiv nu trebuie activat nimic și nu este nevoie de hardware suplimentar. Șablonul este realizat pentru HEOS CLI v1.17, care corespunde versiunii HEOS 2.41.140.

1. Instalați **HEOS App** (Android / iOS) pe un telefon sau o tabletă din aceeași rețea și finalizați configurarea inițială a dispozitivului HEOS, astfel încât acesta să fie conectat la Wi-Fi sau Ethernet. CLI nu este disponibil până la finalizarea acestei configurări.
2. Aflați adresa IP a dispozitivului HEOS — în aplicația HEOS la **Settings → My Devices → About** sau în lista de clienți DHCP a routerului. Produsele HEOS se anunță și în rețeaua locală prin UPnP SSDP (ținta de căutare `urn:schemas-denon-com:device:ACT-Denon:1`).
3. Rezervați această adresă în router (rezervare DHCP) sau setați o adresă IP statică, ca să nu se schimbe după reînnoirea DHCP.
4. Asigurați-vă că TapHome Core poate accesa dispozitivul HEOS pe **portul TCP 1255** — aceeași rețea locală sau o subrețea rutată, fără firewall care să blocheze portul.

Un singur dispozitiv HEOS este suficient: conexiunea la o singură boxă HEOS oferă acces la toate playerele HEOS din rețea, așa că `get_players` le returnează pe toate.

> [!WARNING]
> HEOS CLI nu are autentificare proprie — orice dispozitiv care poate accesa portul TCP 1255 poate trimite comenzi sistemului HEOS. Păstrați produsele HEOS într-un segment de rețea de încredere.

## Configurare

La importul în interfața Packet Parser din aplicația TapHome, introduceți adresa IP a dispozitivului HEOS în parametrul **Adresa IP**; portul și delimitarea mesajelor sunt deja setate în șablon.

| Setare | Valoare |
|--------|---------|
| Transport | TCP, portul 1255 |
| Delimitator de mesaje | `\r\n` pentru comenzi și răspunsuri |
| Conexiune | deschisă la fiecare citire, nu rămâne deschisă (`StayConnected` dezactivat) |
| Interval de citire | 15 s |
| Comandă trimisă | `heos://player/get_players` |
| Valoare memorată | `payload[0].pid` din răspunsul JSON |

Răspunsul la `get_players` este un obiect JSON cu antetul `heos` (`command`, `result`, `message`) și o matrice `payload` cu câte o intrare pentru fiecare player. Fiecare intrare conține `name`, `pid`, `model`, `version` și `network` (`wired` sau `wifi`), plus `lineout`, iar în funcție de dispozitiv `gid` (numai când playerul face parte dintr-un grup), `control` și `serial`. Șablonul păstrează doar `pid`-ul primei intrări.

## Funcțiile dispozitivului

### Denon player id

**Denon player id** este o variabilă care conține ID-ul de player HEOS citit din prima intrare a răspunsului `get_players`. Se actualizează la fiecare 15 secunde, așa că urmărește sistemul HEOS când lista se schimbă. Șablonul nu are script de scriere pentru această variabilă — este destinată doar citirii.

Valoarea poate fi folosită oriunde este nevoie de un `pid` HEOS, de exemplu când se trimite o comandă `heos://player/*` dintr-un alt modul Packet Parser. Când se folosește șablonul complet [Denon HEOS](https://taphome.com/ro/compatibility/denon-heos/), acest șablon auxiliar nu este necesar — acțiunile sale de service **Get Players** și **Set Player Id** listează deja playerele și leagă modulul de playerul ales.

## Rezolvarea problemelor

### Denon player id rămâne gol după import

O boxă HEOS rulează CLI în modul inactiv și îl pornește abia la sosirea primei conexiuni TCP. Imediat după aceea, CLI poate să nu răspundă încă la comenzile pentru playere, deoarece trebuie mai întâi să descopere toate playerele din rețea. Așteptați câteva cicluri de citire (de câte 15 s). Deoarece acest șablon închide conexiunea după fiecare citire, CLI poate reveni în modul inactiv între citiri; de aceea și primele citiri după o pauză mai lungă pot rămâne goale.

Dacă valoarea nu apare deloc, verificați că:

1. Adresa IP din modul aparține în continuare dispozitivului HEOS (rezervare DHCP sau adresă IP statică).
2. Portul TCP 1255 este accesibil din TapHome Core — aceeași rețea locală, fără firewall între ele.
3. Dispozitivul HEOS este complet online în aplicația HEOS.

### Valoarea aparține altei boxe

Șablonul memorează `pid`-ul primului player din listă, care nu este neapărat boxa de la adresa IP introdusă. Când există mai multe playere HEOS, folosiți șablonul principal [Denon HEOS](https://taphome.com/ro/compatibility/denon-heos/), a cărui acțiune de service **Get Players** afișează întreaga listă (nume, `pid`, model), iar **Set Player Id** selectează playerul după indexul numerotat de la 0.

### S-a schimbat pid-ul

HEOS atribuie valorile `pid` playerelor din rețea. Dacă o boxă a fost resetată la setările din fabrică sau înlocuită, poate primi un `pid` nou; Denon player id afișează noua valoare la următoarea citire, dar o valoare copiată în altă parte trebuie actualizată manual.

## Dispozitive disponibile 1

Aceste dispozitive apar în TapHome după import.

Denon discovery Modul

Denon player id Variabilă

Citire (modul)

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

Ascultător

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

**Conexiune:** Packet Parser → TCP

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit      |
|------------------------|---------------|
| Adresă IP              | `192.168.0.1` |

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)