feat: Add out of the box support for Reolink PTZ (#1982)

- Closes: #1964

src/camera-manager/frigate/camera.ts

@@ -1,12 +1,13 @@
 import uniq from 'lodash-es/uniq';
+import { ActionsExecutor } from '../../card-controller/actions/types';
 import { StateWatcherSubscriptionInterface } from '../../card-controller/hass/state-watcher';
+import { PTZAction, PTZActionPhase } from '../../config/schema/actions/custom/ptz';
 import { CameraConfig } from '../../config/schema/cameras';
 import { HomeAssistant } from '../../ha/types';
 import { localize } from '../../localize/localize';
 import { PTZCapabilities, PTZMovementType } from '../../types';
 import { errorToConsole } from '../../utils/basic';
-import { EntityRegistryManager } from '../../utils/ha/registry/entity';
-import { Entity } from '../../utils/ha/registry/entity/types';
+import { Entity, EntityRegistryManager } from '../../utils/ha/registry/entity/types';
 import { Camera, CameraInitializationOptions } from '../camera';
 import { Capabilities } from '../capabilities';
 import { CameraManagerEngine } from '../engine';
@@ -57,6 +58,55 @@ export class FrigateCamera extends Camera {
     return await super.initialize(options);
   }
 
+  public async executePTZAction(
+    executor: ActionsExecutor,
+    action: PTZAction,
+    options?: {
+      phase?: PTZActionPhase;
+      preset?: string;
+    },
+  ): Promise<boolean> {
+    if (await super.executePTZAction(executor, action, options)) {
+      return true;
+    }
+
+    const cameraEntity = this.getConfig().camera_entity;
+    if ((action === 'preset' && !options?.preset) || !cameraEntity) {
+      return false;
+    }
+
+    // Awkward translation between card action and service parameters:
+    // https://github.com/blakeblackshear/frigate-hass-integration/blob/dev/custom_components/frigate/services.yaml
+    await executor.executeActions({
+      actions: {
+        action: 'perform-action',
+        perform_action: 'frigate.ptz',
+        data: {
+          action:
+            options?.phase === 'stop'
+              ? 'stop'
+              : action === 'zoom_in' || action === 'zoom_out'
+                ? 'zoom'
+                : action === 'preset'
+                  ? 'preset'
+                  : 'move',
+          ...(options?.phase !== 'stop' && {
+            argument:
+              action === 'zoom_in'
+                ? 'in'
+                : action === 'zoom_out'
+                  ? 'out'
+                  : action === 'preset'
+                    ? options?.preset
+                    : action,
+          }),
+        },
+        target: { entity_id: cameraEntity },
+      },
+    });
+    return true;
+  }
+
   protected async _initializeConfig(
     hass: HomeAssistant,
     entityRegistryManager: EntityRegistryManager,
@@ -194,10 +244,10 @@ export class FrigateCamera extends Camera {
     // Note: The Frigate integration only supports continuous PTZ movements
     // (regardless of the actual underlying camera capability).
     const panTilt: PTZMovementType[] = [
-      ...(ptzInfo.features?.includes('pt') ? ['continuous' as const] : []),
+      ...(ptzInfo.features?.includes('pt') ? [PTZMovementType.Continuous] : []),
     ];
     const zoom: PTZMovementType[] = [
-      ...(ptzInfo.features?.includes('zoom') ? ['continuous' as const] : []),
+      ...(ptzInfo.features?.includes('zoom') ? [PTZMovementType.Continuous] : []),
     ];
     const presets = ptzInfo.presets;
 

src/camera-manager/frigate/engine-frigate.ts

@@ -4,7 +4,6 @@ import orderBy from 'lodash-es/orderBy';
 import throttle from 'lodash-es/throttle';
 import uniqWith from 'lodash-es/uniqWith';
 import { StateWatcherSubscriptionInterface } from '../../card-controller/hass/state-watcher';
-import { PTZAction, PTZActionPhase } from '../../config/schema/actions/custom/ptz';
 import { CameraConfig } from '../../config/schema/cameras';
 import { HomeAssistant } from '../../ha/types';
 import {
@@ -14,7 +13,7 @@ import {
   runWhenIdleIfSupported,
 } from '../../utils/basic';
 import { getEntityTitle } from '../../utils/ha';
-import { EntityRegistryManager } from '../../utils/ha/registry/entity';
+import { EntityRegistryManager } from '../../utils/ha/registry/entity/types';
 import { ViewMedia } from '../../view/media';
 import { ViewMediaClassifier } from '../../view/media-classifier';
 import { RecordingSegmentsCache, RequestCache } from '../cache';
@@ -1005,44 +1004,4 @@ export class FrigateCameraManagerEngine
       ...(jsmpeg && { jsmpeg: jsmpeg }),
     };
   }
-
-  public async executePTZAction(
-    hass: HomeAssistant,
-    cameraConfig: CameraConfig,
-    action: PTZAction,
-    options?: {
-      phase?: PTZActionPhase;
-      preset?: string;
-    },
-  ): Promise<void> {
-    const cameraEntity = cameraConfig.camera_entity;
-
-    if (action === 'preset' && !options?.preset) {
-      return;
-    }
-
-    // Awkward translation between card action and service parameters:
-    // https://github.com/blakeblackshear/frigate-hass-integration/blob/dev/custom_components/frigate/services.yaml
-    await hass.callService('frigate', 'ptz', {
-      entity_id: cameraEntity,
-      action:
-        options?.phase === 'stop'
-          ? 'stop'
-          : action === 'zoom_in' || action === 'zoom_out'
-            ? 'zoom'
-            : action === 'preset'
-              ? 'preset'
-              : 'move',
-      ...(options?.phase !== 'stop' && {
-        argument:
-          action === 'zoom_in'
-            ? 'in'
-            : action === 'zoom_out'
-              ? 'out'
-              : action === 'preset'
-                ? options?.preset
-                : action,
-      }),
-    });
-  }
 }