Pantallas digitales
Última actualización:
Lo que aprenderás
- Ciclo de vida de una DisplayUnit sin y con Player.
- Flujo de emparejamiento y precedencia de los datos medidos.
- Diferencias entre reemparejar, reemplazar, liberar y desconectar.
Antes de empezar
- Rol
- Superadministrador · Administrador · Gerente
- Permiso
- devices.pair · inventory.write
- Inventario
- digital-only o mixed
Ruta: /inventory/screens. API: api/PlannedScreens, api/Pairing, api/DisplayUnits. La
pantalla es la identidad; el dispositivo es reemplazable.
- UsuariounpairedPOST api/PlannedScreens: DisplayUnit + Face digital + Player reservado. Vendible y compilable
- instalaciónCampoCódigo en pantallael player muestra un código; rota cada 60 s, válido 15 min
- CMSUsuarioClaimGET api/Pairing/preview/{code} → POST api/Pairing/claim con TargetPlayerId
- automáticoSistemaconnectedcredencial emitida; recompilación de playlist
Pantalla planeada
Sección titulada «Pantalla planeada»POST api/PlannedScreens crea en una transacción DisplayUnit, Face digital y Player
(Status = unpaired, sin clave ni credencial) con su configuración.
- Acepta ventas y compila playlist.
- Excluida del catálogo de Shareflow Ads y del NOC.
- Entrega de campañas: estado
awaiting_device(«Esperando equipo»), no «Player desconectado». - Para una cara digital sin pantalla:
POST api/PlannedScreens/for-face/{faceId}.
Emparejamiento
Sección titulada «Emparejamiento»- El player muestra el código de emparejamiento.
- CMS → pantalla → Emparejar equipo (o Conectar pantalla). Introduce el código.
GET api/Pairing/preview/{code}devuelve los siete atributos de hardware con los no detectados marcados (0/null).- Completa sitio, nombre y pulgadas.
POST api/Pairing/claim. El primer claim liga el dispositivo (first_installation), conserva la configuración y recompila la playlist.
| Dato | Regla |
|---|---|
| Resolución, orientación, refresco, modelo reportados | no sobrescribibles → 400 |
| Resolución distinta de la planeada | 409 sin AcceptDetectedResolution; con él reescribe pantalla, config y orientación de la cara |
| Dato no detectado | lo aporta el operador con ConfirmManualResolution |
PairingSession.HardwareJson conserva lo reportado; lo confirmado vive en la DisplayUnit.
Ficha pendiente
Sección titulada «Ficha pendiente»/inventory/faces/{id} muestra «Completa la ficha» hasta declarar fotos, audiencia
(traffic, AverageDwellSeconds, emplazamiento para VAC) y emplazamiento.
Operaciones sobre el dispositivo
Sección titulada «Operaciones sobre el dispositivo»| Operación | Endpoint | Credencial | Clave pública | Pantalla |
|---|---|---|---|---|
| Reemparejar | claim con el mismo dispositivo | rotada | conservada | misma; conserva WAL y caché |
| Reemplazar | claim con ReplaceHardware |
nueva | nueva | misma; cadena re-anclada (hardware_replaced); se pierden plays no reportados del dispositivo anterior |
| Liberar | POST api/Pairing/players/{id}/release |
revocada | conservada | el dispositivo recibe 410 device_unpaired |
| Desconectar | POST api/Pairing/players/{id}/unpair |
borrada | borrada | queda unpaired; dispositivo libre |
- Player ≥ 0.2.8 anuncia
POST /v1/devices/{id}/re-pairing; durante 30 minStatus = re_pairingsinconnection_lost, sin caso NOC. DELETE api/Players/{id}con cara asociada → rechazo; usar Desconectar.- Pantalla o cara con venta vigente: desconexión y borrado devuelven
409con la venta.