← ClaudeAtlas

bravia-apilisted

Referencia del protocolo de control IP de las TVs Sony BRAVIA (JSON-RPC /sony/*, IRCC SOAP, autenticación por PSK o PIN, SSDP y WOL). Úsala al escribir código que controle una BRAVIA por red, al añadir una orden o al depurar una conexión que falla.
salvatejero/myclaude-skills · ★ 0 · API & Backend · score 72
Install: claude install-skill salvatejero/myclaude-skills
# Protocolo BRAVIA Fuentes: la documentación pública de Sony "BRAVIA Professional Displays — IP Control / REST API" (pro-bravia.sony.net). ## Transporte - HTTP en el puerto 80, sin TLS. En una app de iOS, en el Info.plist hacen falta `NSAllowsLocalNetworking` y `NSLocalNetworkUsageDescription`. - JSON-RPC: `POST http://<ip>/sony/<servicio>` con el cuerpo `{"method": "...", "params": [...], "id": 1, "version": "1.0"}`. - Si va bien, devuelve `{"result": [...], "id": 1}`; si falla, `{"error": [código, "mensaje"], "id": 1}`. Un error puede llegar con HTTP 200, así que hay que mirar siempre la clave `error`. ## Autenticación (una de las dos) - **PSK**: se envía la cabecera `X-Auth-PSK: <clave>` en todas las peticiones, JSON y SOAP. - **PIN**: `POST /sony/accessControl` con `actRegister` y estos params: `[{"clientid": "<app>:<uuid>", "nickname": "<nombre>", "level": "private"}, [{"value": "yes", "function": "WOL"}]]`. - Sin `Authorization` → la TV responde **401** y muestra un PIN de 4 dígitos. - Se repite con `Authorization: Basic base64(":" + pin)` → 200 y cookie `auth`. URLSession la guarda y la reenvía sola; caduca y se renueva con otro `actRegister`. - El `clientid` tiene que ser estable (se guarda un UUID), porque si cambia se pide otro PIN. ## Servicios y métodos útiles | Servicio | Método | Notas | |---|---|---| | system | `getRemoteControllerInfo` | `result = [{bundled,type}, [{name, value}]]`: nombre de tecla → código IRCC. **Varía según el mode