dgreif · dgreif · Dec 22, 2024
diff --git a/.changeset/afraid-waves-rhyme.md b/.changeset/afraid-waves-rhyme.md
@@ -0,0 +1,5 @@
+---
+'homebridge-ring': major
+---
+
+Removed bridged cameras. If you already had `unbridgeCameras: true` in your config, this change will not affect you. For those who were still using bridged cameras, you will need to manually add each camera to HomeKit after upgrading. This change allows us to stop requiring special builds of ffmpeg and should make video streaming more reliable. Unbridge cameras are also avoid blocking the whole bridge while waiting for requests (e.g. Snapshot), which leads to a better overall experience.
diff --git a/packages/homebridge-ring/README.md b/packages/homebridge-ring/README.md
diff --git a/packages/homebridge-ring/camera-source.ts b/packages/homebridge-ring/camera-source.ts
@@ -72,25 +72,6 @@ class StreamingSessionWrapper {
   videoSplitter = new RtpSplitter()
   repacketizeAudioSplitter = new RtpSplitter()
 
-  libfdkAacInstalledPromise = doesFfmpegSupportCodec(
-    'libfdk_aac',
-    getFfmpegPath(),
-  )
-    .then((supported) => {
-      if (!supported) {
-        logError(
-          'Streaming video only - found ffmpeg, but libfdk_aac is not installed. See https://github.com/dgreif/ring/wiki/FFmpeg for details.',
-        )
-      }
-      return supported
-    })
-    .catch(() => {
-      logError(
-        'Streaming video only - ffmpeg was not found. See https://github.com/dgreif/ring/wiki/FFmpeg for details.',
-      )
-      return false
-    })
-
   constructor(
     public streamingSession: StreamingSession,
     public prepareStreamRequest: PrepareStreamRequest,
@@ -262,38 +243,19 @@ class StreamingSessionWrapper {
       }),
     )
 
-    const shouldTranscodeAudio = await this.libfdkAacInstalledPromise
-    if (!shouldTranscodeAudio) {
-      return this.streamingSession.requestKeyFrame()
-    }
-
     const transcodingPromise = this.streamingSession.startTranscoding({
       input: ['-vn'],
       audio: [
         '-map',
         '0:a',
 
-        ...(request.audio.codec === AudioStreamingCodecType.OPUS
-          ? [
-              // OPUS specific - it works, but audio is very choppy
-              '-acodec',
-              'libopus',
-              '-frame_duration',
-              request.audio.packet_time,
-              '-application',
-              'lowdelay',
-            ]
-          : [
-              // AAC-eld specific
-              '-acodec',
-              'libfdk_aac',
-              '-profile:a',
-              'aac_eld',
-              '-eld_sbr:a',
-              '1',
-              '-eld_v2',
-              '1',
-            ]),
+        // OPUS specific - it works, but audio is very choppy
+        '-acodec',
+        'libopus',
+        '-frame_duration',
+        request.audio.packet_time,
+        '-application',
+        'lowdelay',
 
         // Shared options
         '-flags',
@@ -337,7 +299,6 @@ class StreamingSessionWrapper {
 
         return null
       }),
-      isRingUsingOpus = await this.streamingSession.isUsingOpus,
       returnAudioTranscoder = new ReturnAudioTranscoder({
         prepareStreamRequest: this.prepareStreamRequest,
         startStreamRequest: request,
@@ -347,19 +308,15 @@ class StreamingSessionWrapper {
         },
         outputArgs: [
           '-acodec',
-          ...(isRingUsingOpus
-            ? [
-                'libopus',
-                '-ac',
-                '1',
-                '-ar',
-                '24k',
-                '-b:a',
-                '24k',
-                '-application',
-                'lowdelay',
-              ]
-            : ['pcm_mulaw', '-ac', 1, '-ar', '8k']),
+          'libopus',
+          '-ac',
+          '1',
+          '-ar',
+          '24k',
+          '-b:a',
+          '24k',
+          '-application',
+          'lowdelay',
           '-flags',
           '+global_header',
           '-f',
@@ -398,10 +355,7 @@ export class CameraSource implements CameraStreamingDelegate {
   private sessions: { [sessionKey: string]: StreamingSessionWrapper } = {}
   private cachedSnapshot?: Buffer
 
-  constructor(
-    private ringCamera: RingCamera,
-    private useOpus = false,
-  ) {
+  constructor(private ringCamera: RingCamera) {
     this.controller = new hap.CameraController({
       cameraStreamCount: 10,
       delegate: this,
@@ -425,28 +379,21 @@ export class CameraSource implements CameraStreamingDelegate {
           },
         },
         audio: {
-          codecs: this.useOpus
-            ? [
-                {
-                  type: AudioStreamingCodecType.OPUS,
-                  // required by watch
-                  samplerate: AudioStreamingSamplerate.KHZ_8,
-                },
-                {
-                  type: AudioStreamingCodecType.OPUS,
-                  samplerate: AudioStreamingSamplerate.KHZ_16,
-                },
-                {
-                  type: AudioStreamingCodecType.OPUS,
-                  samplerate: AudioStreamingSamplerate.KHZ_24,
-                },
-              ]
-            : [
-                {
-                  type: AudioStreamingCodecType.AAC_ELD,
-                  samplerate: AudioStreamingSamplerate.KHZ_16,
-                },
-              ],
+          codecs: [
+            {
+              type: AudioStreamingCodecType.OPUS,
+              // required by watch
+              samplerate: AudioStreamingSamplerate.KHZ_8,
+            },
+            {
+              type: AudioStreamingCodecType.OPUS,
+              samplerate: AudioStreamingSamplerate.KHZ_16,
+            },
+            {
+              type: AudioStreamingCodecType.OPUS,
+              samplerate: AudioStreamingSamplerate.KHZ_24,
+            },
+          ],
         },
       },
     })

diff --git a/packages/homebridge-ring/camera.ts b/packages/homebridge-ring/camera.ts
@@ -20,10 +20,7 @@ export class Camera extends BaseDataAccessory<RingCamera> {
   ) {
     super()
 
-    this.cameraSource = new CameraSource(
-      this.device,
-      this.config.unbridgeCameras,
-    )
+    this.cameraSource = new CameraSource(this.device)
 
     if (!hap.CameraController) {
       const error =

diff --git a/packages/homebridge-ring/config.schema.json b/packages/homebridge-ring/config.schema.json
@@ -16,11 +16,6 @@
         "description": "Click \"Generate New Refresh Token\" above to change accounts or if your refresh token has expired",
         "placeholder": "Refresh Token"
       },
-      "unbridgeCameras": {
-        "title": "Unbridge Cameras",
-        "type": "boolean",
-        "description": "If enabled, all Ring Cameras we be treated as external accessories, which generally leads to better performance. This means they each need to be individually added to HomeKit. This option will be enabled by default in the next major release. WARNING: If your cameras are already bridged, they will be deleted from HomeKit when you enable this option, and you will need to reconfigure any associated automations or HomeKit settings"
-      },
       "alarmOnEntryDelay": {
         "title": "Alarm on Entry Delay",
         "type": "boolean",
@@ -157,7 +152,6 @@
       "title": "Optional Configuration",
       "expandable": true,
       "items": [
-        "unbridgeCameras",
         "alarmOnEntryDelay",
         "hideLightGroups",
         "hideDoorbellSwitch",

diff --git a/packages/homebridge-ring/config.ts b/packages/homebridge-ring/config.ts
@@ -22,7 +22,6 @@ export interface RingPlatformConfig extends RingApiOptions {
   nightModeBypassFor: AlarmMode
   onlyDeviceTypes?: string[]
   showPanicButtons?: boolean
-  unbridgeCameras?: boolean
   disableLogs?: boolean
 }
 

diff --git a/packages/homebridge-ring/ring-platform.ts b/packages/homebridge-ring/ring-platform.ts
@@ -211,7 +211,6 @@
       platformAccessories: PlatformAccessory[] = [],
       externalAccessories: PlatformAccessory[] = [],
       activeAccessoryIds: string[] = []
-    let hasBridgedCameras = false
 
     logInfo('Found the following locations:')
 
@@ -286,8 +285,7 @@
         hapDevices.forEach(
           ({ deviceType, device, isCamera, id, name, AccessoryClass }) => {
             const uuid = hap.uuid.generate(debugPrefix + id),
-              displayName = debugPrefix + name,
-              isExternalCamera = isCamera && this.config.unbridgeCameras
+              displayName = debugPrefix + name
 
             if (
               !AccessoryClass ||
@@ -302,7 +300,8 @@
               return
             }
 
-            if (isExternalCamera && this.homebridgeAccessories[uuid]) {
+            // TODO: I think we can remove this, uuid is different with the camera differentiator
+            if (isCamera && this.homebridgeAccessories[uuid]) {
               // Camera was previously bridged.  Remove it from the platform so that it can be added as an external accessory
               this.log.warn(
                 `Camera ${displayName} was previously bridged. You will need to manually pair it as a new accessory.`,
@@ -322,7 +321,7 @@
                     : hap.Categories.SECURITY_SYSTEM,
                 )
 
-                if (isExternalCamera) {
+                if (isCamera) {
                   logInfo(
                     `Configured camera ${uuid} ${deviceType} ${displayName}`,
                   )
@@ -334,17 +333,6 @@
                   platformAccessories.push(accessory)
                 }
 
-                if (
-                  isCamera &&
-                  !isExternalCamera &&
-                  typeof hap.Accessory.cleanupAccessoryData === 'function'
-                ) {
-                  // This is a one-time cleanup that will remove persist files for old external accessories from unbridged cameras
-                  hap.Accessory.cleanupAccessoryData(
-                    generateMacAddress(accessory.UUID),
-                  )
-                }
-
                 return accessory
               },
               homebridgeAccessory =
@@ -358,8 +346,6 @@
 
             this.homebridgeAccessories[uuid] = homebridgeAccessory
             activeAccessoryIds.push(uuid)
-
-            hasBridgedCameras ||= isCamera && !isExternalCamera
           },
         )
       }),
@@ -406,11 +392,5 @@
         })
       },
     )
-
-    if (hasBridgedCameras) {
-      logError(
-        'Bridged camera support will be removed in the next major release of homebridge-ring. Please enable the unbridgeCameras option in your configuration and add the individual cameras to HomeKit to prepare for this change.',
-      )
-    }
   }
 }