@chrisalvir1/camera-ui-homekit-4k 0.6.26-beta.3 → 0.6.26-beta.5

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.6.26-beta.5] — AAC-ELD for non-Ring H.264, including local Wi-Fi
+
+- Offer and accept AAC-ELD 24 kHz mono exclusively for all non-Ring H.264 sources, including current and future Tapo, Wyze, Ezviz and generic cameras. Ring keeps its existing Opus route.
+- Give only non-Ring H.264 RTP services stable, versioned identities so HomeKit refreshes cached Opus capabilities. HAP's configuration hash excludes characteristic values; changing the audio list or plugin firmware alone did not change the service graph. Accessory/pairing, recording and sensor identities remain stable; subsequent boots reuse the same new RTP identities.
+- Fail explicitly if AAC-ELD encoding is unavailable. An empty audio offer is unsafe because HAP inserts a synthetic Opus offer.
+- Audit found Ezviz and Wyze set to streaming only in Apple Home for both presence modes. Enabled their requested event recording in the audited home; person, animal, vehicle and audio recording settings are enabled. C120 already allowed recording. These are household settings, not package defaults: choose “Stream & Allow Recording” for new accessories in Apple Home.
+- No changes to HEVC/HKSV3, Ring media processing or H.264 recording/detection implementations. Real FFmpeg AAC-ELD encode/decode and RTP timing tests pass; migration tests verify wire codec, refreshed live IIDs and preserved recording/sensor IDs.
+
+## [0.6.26-beta.4] — H.264 Wi-Fi live negotiation fallback
+
+- The Mac mini log showed that an iPhone on the local Wi-Fi completed HAP `PREPARE`, then requested Opus at 24 kHz in `START`; beta.3 advertised only AAC-ELD and rejected the request before sending RTP. This explains why cellular playback through the Home Hub worked while direct local playback failed.
+- Keep AAC-ELD 24 kHz first for non-Ring H.264 cameras and also advertise/accept Opus at 16/24 kHz for controllers using a cached Opus selection. Use the RFC 7587 48 kHz RTP clock for this Opus route. Ring remains on its existing Opus-only profile.
+- HEVC/HKSV3, H.264 recording/detection, pairing, video passthrough and camera settings are unchanged. Unit/integration checks pass; direct iPhone Wi-Fi playback still needs confirmation after installation.
+
 ## [0.6.26-beta.3] — H.264 live audio AAC-ELD fallback; preserve Ring Opus
 
 - H.264 non-Ring sources now advertise AAC-ELD only, and only after the installed Camera.UI FFmpeg passes an actual AAC-ELD encode check. This prevents HomeKit choosing the Opus route that the latest iPhone log shows on C120, Wyze, EZVIZ and C402.

package/README.md

@@ -12,20 +12,18 @@ can stop a camera's export in that camera's settings; this choice persists and
 prevents automatic republication. An unavailable/unknown source is retried a
 few times; selecting a different source in that camera's settings retries it.
 
-**Working version 0.6.22** resolves the HomeKit live stream "Sin respuesta" issue by
-strictly matching IP address versions in HAP prepareStream, preserving native RFC 6184 NAL unit integrity,
-and delivering crystal-clear 48 kHz Opus audio with video passthrough for $\le$1080p and Apple Silicon 2K hardware transcoding for >1080p.
-**Release 0.6.21** non-blocking H.264 start response.
-**Release 0.6.19** restores standard H.264 resolution choices in the HomeKit offer.
-**Release 0.6.18** added initial Opus negotiation handling. **Release 0.6.17** adds LAN-aware mDNS.
-Runtime behavior was validated on the developer MacBook with Camera.UI 2.3.0;
-see the changelog for the scope of each release and its validation evidence.
+**Beta 0.6.26-beta.5** uses AAC-ELD 24 kHz mono for live audio on every
+non-Ring H.264 camera. Ring retains its existing Opus route. This policy applies
+automatically to current and future H.264 exports and includes a one-time refresh
+of their live-service identities to replace cached Opus capabilities without
+removing the paired accessory. See the changelog for validation evidence.
 
 ## Current behavior
 
 - H.264 sources at or below 1920×1080 are sent without video transcoding;
   measured larger H.264 sources use a 1920×1080 output path. Audio is handled
-  separately according to HomeKit negotiation.
+  separately: AAC-ELD for non-Ring live audio, Opus for Ring live audio and
+  AAC-LC 48 kHz mono for H.264 HKSV recordings.
 - HEVC/H.265 uses its separate live and HKSV3 paths. HEVC recording and live
   implementations are isolated from the H.264 resolution policy.
 - Camera.UI motion and visual detection events feed HomeKit's motion trigger for
@@ -39,6 +37,10 @@ see the changelog for the scope of each release and its validation evidence.
   media request; saved vehicle/animal clips were not yet confirmed.
 - Pairing identities and per-camera persistent settings are stored by the
   Camera.UI plugin runtime. Do not delete them when updating the package.
+- To record HKSV clips, select **Stream & Allow Recording** in Apple Home for
+  both **When Home** and **When Away**, then enable the desired event categories
+  and **Record Audio**. **Stream** alone never records clips, even with active
+  Camera.UI detectors. These household choices are managed in Apple Home.
 
 ## Requirements and installation
 
@@ -67,5 +69,6 @@ replace playback, recording, or detection confirmation in Apple Home. See the
 
 The package is public on npm under a proprietary license: users may download,
 install, and run an unmodified copy; modifying or redistributing it is not
-permitted without the author's written permission. Version 0.6.17 is the current release.
+permitted without the author's written permission. Prereleases use the npm `beta`
+channel; the stable `latest` channel is separate.
 Use Camera.UI's supported plugin installer to install the latest public release.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chrisalvir1/camera-ui-homekit-4k",
   "displayName": "HOMEKIT 4K — by Chrisalvir",
-  "version": "0.6.26-beta.3",
+  "version": "0.6.26-beta.5",
   "description": "Exports Camera.UI cameras to Apple Home with H.264/HKSV and HEVC/HKSV3 streaming paths.",
   "homepage": "https://github.com/Chrisalvir1/homekit-4k",
   "repository": {