feat: Add control/output of selected camera via an entity (#1895)

- Closes #1871

src/card-controller/config/config-manager.ts

@@ -14,6 +14,7 @@ import { InitializationAspect } from '../initialization-manager.js';
 import { CardConfigAPI } from '../types.js';
 import { getOverriddenConfig } from './get-overridden-config.js';
 import { setAutomationsFromConfig } from './load-automations.js';
+import { setRemoteControlEntityFromConfig } from './load-control-entities.js';
 import { setKeyboardShortcutsFromConfig } from './load-keyboard-shortcuts.js';
 
 export class ConfigManager {
@@ -109,7 +110,8 @@ export class ConfigManager {
     this._api.getMessageManager().reset();
     this._api.getStatusBarItemManager().removeAllDynamicStatusBarItems();
 
-    setKeyboardShortcutsFromConfig(this._api, this);
+    setKeyboardShortcutsFromConfig(this._api);
+    setRemoteControlEntityFromConfig(this._api);
     setAutomationsFromConfig(this._api);
 
     this._processOverrideConfig();

src/card-controller/config/load-control-entities.ts

@@ -0,0 +1,98 @@
+import {
+  createCameraAction,
+  createInternalCallbackAction,
+  createPerformAction,
+} from '../../utils/action';
+import { CardActionsAPI, CardConfigLoaderAPI, TaggedAutomation } from '../types';
+
+export const setRemoteControlEntityFromConfig = (api: CardConfigLoaderAPI) => {
+  const automationTag = setRemoteControlEntityFromConfig;
+
+  api.getAutomationsManager().deleteAutomations(automationTag);
+
+  const cameraControlEntity = api.getConfigManager().getConfig()?.remote_control
+    ?.entities?.camera;
+  if (!cameraControlEntity) {
+    return;
+  }
+
+  const createSelectOptionAction = (option: string) =>
+    createPerformAction('input_select.select_option', {
+      target: {
+        entity_id: cameraControlEntity,
+      },
+      data: {
+        option: option,
+      },
+    });
+
+  // Control entities functionality is implemented entirely by populating
+  // automations.
+
+  const automations: TaggedAutomation[] = [
+    {
+      conditions: [
+        {
+          condition: 'config' as const,
+          paths: ['remote_control.entities.camera'],
+        },
+      ],
+      actions: [
+        // Set the possible options on the entity to the camera IDs via a
+        // callback to `setCameraOptionsOnEntity` (below).
+        createInternalCallbackAction((api: CardActionsAPI) =>
+          setCameraOptionsOnEntity(cameraControlEntity, api),
+        ),
+        // Set the selected option to the current camera ID.
+        createSelectOptionAction('{{ advanced_camera_card.camera }}'),
+      ],
+      tag: automationTag,
+    },
+    {
+      conditions: [
+        {
+          condition: 'camera' as const,
+        },
+      ],
+      actions: [
+        // When the camera changes, update the entity to match.
+        createSelectOptionAction('{{ advanced_camera_card.trigger.camera.to }}'),
+      ],
+      tag: automationTag,
+    },
+    {
+      conditions: [
+        {
+          condition: 'state' as const,
+          entity: cameraControlEntity,
+        },
+      ],
+      actions: [
+        // When the entity state changes, updated the selected option.
+        createCameraAction(
+          'camera_select',
+          '{{ advanced_camera_card.trigger.state.to }}',
+        ),
+      ],
+      tag: automationTag,
+    },
+  ];
+
+  api.getAutomationsManager().addAutomations(automations);
+};
+
+const setCameraOptionsOnEntity = async (entity: string, api: CardActionsAPI) => {
+  const hass = api.getHASSManager().getHASS();
+  const cameraIDs = api.getCameraManager().getStore().getCameraIDs();
+
+  await hass?.callService(
+    'input_select',
+    'set_options',
+    {
+      options: [...cameraIDs],
+    },
+    {
+      entity_id: entity,
+    },
+  );
+};

src/card-controller/config/load-keyboard-shortcuts.ts

@@ -6,18 +6,16 @@ import { PTZAction } from '../../config/ptz';
 import { createPTZMultiAction } from '../../utils/action';
 import { CardConfigLoaderAPI, TaggedAutomation } from '../types';
 
-export const setKeyboardShortcutsFromConfig = (
-  api: CardConfigLoaderAPI,
-  tag: unknown,
-) => {
-  api.getAutomationsManager().deleteAutomations(tag);
+export const setKeyboardShortcutsFromConfig = (api: CardConfigLoaderAPI) => {
+  const automationTag = setKeyboardShortcutsFromConfig;
+  api.getAutomationsManager().deleteAutomations(automationTag);
 
   const shortcuts = api.getConfigManager().getConfig()?.view.keyboard_shortcuts;
   if (!shortcuts) {
     return;
   }
 
-  const automations = convertKeyboardShortcutsToAutomations(tag, shortcuts);
+  const automations = convertKeyboardShortcutsToAutomations(automationTag, shortcuts);
   if (automations.length) {
     api.getAutomationsManager().addAutomations(automations);
   }