Ir al contenido

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.

  1. UsuariounpairedPOST api/PlannedScreens: DisplayUnit + Face digital + Player reservado. Vendible y compilable
  2. instalación
    CampoCódigo en pantallael player muestra un código; rota cada 60 s, válido 15 min
  3. CMS
    UsuarioClaimGET api/Pairing/preview/{code} → POST api/Pairing/claim con TargetPlayerId
  4. automático
    Sistemaconnectedcredencial emitida; recompilación de playlist
Estados de Player.

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}.
  1. El player muestra el código de emparejamiento.
  2. CMS → pantalla → Emparejar equipo (o Conectar pantalla). Introduce el código.
  3. GET api/Pairing/preview/{code} devuelve los siete atributos de hardware con los no detectados marcados (0/null).
  4. Completa sitio, nombre y pulgadas.
  5. 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.

/inventory/faces/{id} muestra «Completa la ficha» hasta declarar fotos, audiencia (traffic, AverageDwellSeconds, emplazamiento para VAC) y emplazamiento.

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 min Status = re_pairing sin connection_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 409 con la venta.