# cam : webcam, son bidirectionnel et enceinte Bluetooth via Cloudflare Page web `https://kaisa.esiah.dev/mic` : video + son de la webcam du serveur, et micro du navigateur vers une enceinte Bluetooth branchee sur le serveur. Aucun port ouvert sur le routeur ni sur le serveur : tout passe par le tunnel Cloudflare. ## Architecture Navigateur --HTTPS--> Cloudflare (Access + Tunnel) --> cloudflared (app-tunnel) | reseau docker shared-network /mic* --> mic-bridge:8090 (page + WebSocket micro -> paplay -> Pulse -> Bluetooth) reste --> go2rtc:1984 (video MSE + son camera) - **go2rtc** : lit la webcam (`/dev/video0` + carte son ALSA `webcam`) via ffmpeg (H.264 baseline + AAC) et la diffuse en MSE par HTTP/WebSocket. - **mic-bridge** : sert la page `/mic`, recoit l'audio du navigateur en WebSocket (PCM 16 bits mono) et le joue sur l'enceinte via PulseAudio/PipeWire. Son entrypoint reconnecte l'enceinte et remet son volume toutes les 15 s. - **Limite** : ce n'est pas du WebRTC (Cloudflare ne transporte pas l'UDP). Latence du micro ~200 a 500 ms, mode ON/OFF et non duplex natif. ## Arborescence /srv/apps/cam docker-compose.yml services go2rtc + mic-bridge go2rtc.yaml flux webcam (gain camera : volume=XXdB) Makefile commandes de gestion mic-bridge/ Dockerfile, server.js, index.html, entrypoint.sh scripts/cam-watch.* surveillance webcam (cron) ## Prerequis - Debian avec Docker + Compose, `make`, PipeWire (`pipewire-pulse`), BlueZ. - Reseau docker externe `shared-network` (partage avec le conteneur `app-tunnel`). - Utilisateur `esiahdmin` (UID 1001) : le socket Pulse est dans `/run/user/1001`. - Enceinte Bluetooth appairee (`69:B2:C0:04:A4:80`). ## Installation ```bash cd /srv/apps/cam make host-setup # une seule fois : linger, pipewire au boot, trust BT, micro webcam make up make cron-install # surveillance webcam make status ``` ## Configuration Cloudflare (dashboard, une seule fois) 1. **Tunnel** (Networks > Tunnels > Public Hostname), dans cet ordre : - `kaisa.esiah.dev` + chemin `mic*` -> `HTTP` `mic-bridge:8090` - `kaisa.esiah.dev` + chemin vide -> `HTTP` `go2rtc:1984` 2. **Access** (Access > Applications) : une seule application sur `kaisa.esiah.dev` avec deux destinations : sans chemin, et `mic*`. Politique Allow limitee a votre email (One-time PIN si le fournisseur d'identite pose probleme). 3. **Page d'accueil** (Rules > Redirect Rules) : `http.host eq "kaisa.esiah.dev"` et `http.request.uri.path eq "/"` -> redirection statique 302 vers `https://kaisa.esiah.dev/mic`. Ne jamais supprimer la destination sans chemin dans Access : l'API go2rtc, camera comprise, deviendrait publique. ## Utilisation - Ouvrir `https://kaisa.esiah.dev` (ou l'icone ajoutee a l'ecran d'accueil du telephone). - Cliquer sur la video pour activer le son de la camera. - Bouton **Micro ON/OFF** : active le micro du navigateur. Le son de la camera est coupe chez vous pendant que le micro est ON (evite l'echo). - Curseur **Gain** : volume de votre voix dans l'enceinte (0.2 a 5, defaut 1). - Le WebSocket se reconnecte seul ; l'ecran reste allume via Wake Lock si le navigateur le permet. ## Commandes (`make help`) | Commande | Effet | |---|---| | `make up` / `down` / `restart` | Demarrer, arreter, redemarrer | | `make rebuild` / `update` | Reconstruire sans cache / mettre a jour les images | | `make status` | Diagnostic : webcam, carte son, conteneurs, Bluetooth, flux | | `make logs` / `logs-cam` / `logs-mic` | Logs en continu | | `make bt` | Reconnecter l'enceinte | | `make audio-fix` | Relancer pipewire + enceinte | | `make usb-reset` | Reset du controleur USB (coupe aussi le Bluetooth) | | `make speaker` | Bruit de test dans l'enceinte | | `make level` | Niveau du son camera (viser -25 a -30 dB) | | `make gain-cam GAIN=15` | Gain du son camera (dB) | | `make sink-volume SINKVOL=60%` | Volume de l'enceinte | | `make cron-install` / `cron-remove` / `cron-log` | Surveillance webcam | Variables surchargeables : `BT_MAC`, `USER_ID`, `PCI_USB`, `GAIN`, `SINKVOL`. ## Reglages - **Son camera trop faible/fort** : `make gain-cam GAIN=...` (12 par defaut, plage utile 8 a 20). - **Echo** : eloigner l'enceinte de la webcam, baisser `make sink-volume SINKVOL=50%`. - **Voix trop faible dans l'enceinte** : curseur Gain de la page, puis volume de l'enceinte. ## Depannage | Symptome | Cause probable | Action | |---|---|---| | Pas d'image, `ERR [exec] timeout` | Webcam absente | `make status`; si `/dev/video*` absent : debrancher 30 s, rebrancher a l'arriere de la carte mere, `make restart` | | `dmesg` : `error -110` / `-62` sur `usb 1-3` | Alimentation/cable/port USB | Cable court, port direct, hub alimente, autre port ; sinon webcam defectueuse | | Image OK, pas de son camera | Son coupe par le navigateur ou gain trop bas | Cliquer sur la video ; `make level` | | Micro : WebSocket refuse (302) | Access ne couvre pas `/mic/ws` | Verifier les deux destinations de l'application Access | | Micro OK mais silence | Enceinte deconnectee | `make bt` ou `make audio-fix` ; `make speaker` pour tester | | `404` sur `/stream.html` | Regle tunnel manquante ou mal ordonnee | `mic*` d'abord, la regle sans chemin en dernier | | Boucle de 3 boutons dans la page | `/stream.html` route vers mic-bridge | Meme cause que ci-dessus | | Plus de son apres redemarrage pipewire | Sink Bluetooth perdu | `make audio-fix` | | Firefox : micro silencieux | AudioContext a 16 kHz refuse | Deja gere : la page utilise la frequence native du navigateur | Journal de la surveillance : `make cron-log` (`/var/log/cam-watch.log`). ## Securite - Aucun port publie : tout est joignable uniquement via le reseau docker et le tunnel. - Cloudflare Access est la seule barriere d'authentification : ne jamais la desactiver. - go2rtc tourne en `privileged` avec `/dev` monte pour survivre aux reenumerations USB. Si la webcam devient stable, remplacer par `devices: [/dev/video0, /dev/snd]` + `group_add: [video, audio]`. - Le conteneur mic-bridge monte `/run/user/1001` et le bus D-Bus pour piloter Bluetooth/Pulse. ## Sauvegarde et restauration Tout est dans `/srv/apps/cam` (pas de volume de donnees). Sauvegarder ce dossier (par exemple dans le depot git) et rejouer : ```bash make host-setup && make up && make cron-install ```