ESP32S3_vt/desktop/src/lib/ipc.ts

/**
 * 后端命令的封装。
 *
 * 每个函数对应 `desktop/src-tauri/src/commands.rs` 里的一个 `#[tauri::command]`。
 * Tauri 会把 JS 侧的 camelCase 参数名转成 Rust 侧的 snake_case，所以这里的参数名写成
 * 前端习惯的样子即可。
 *
 * # 错误
 *
 * 后端的 `Err(String)` 会以 rejected promise 的形式回来，字符串就是给现场的人看的那句
 * 话。`call()` 把 `unknown` 归一成 `Error`，调用方只管 `catch (err) { err.message }`。
 */

import { invoke } from "@tauri-apps/api/core";

import type {
  ConfigView,
  HudView,
  MediaFileDto,
  RecordingDto,
  Role,
  Snapshot,
  StreamInfo,
} from "./types";

/**
 * 把后端的字符串错误变成真正的 `Error`。
 *
 * 在没有 Tauri 的 `vite dev` 会话里（`?preview=` 那种），这条走预览实现——它用
 * `await import()` 引入，所以正式构建里那段代码根本不会被打进产物（见 `dev-preview.ts`）。
 */
async function call<T>(command: string, args?: Record<string, unknown>): Promise<T> {
  if (import.meta.env.DEV && !("__TAURI_INTERNALS__" in window)) {
    const preview = await import("./dev-preview");
    return preview.previewInvoke<T>(command, args);
  }

  try {
    return await invoke<T>(command, args);
  } catch (raw) {
    throw new Error(typeof raw === "string" ? raw : String(raw));
  }
}

export const api = {
  // ---- 只读 ----
  streamInfo: () => call<StreamInfo>("stream_info"),
  snapshot: () => call<Snapshot>("get_snapshot"),
  config: () => call<ConfigView>("get_config"),
  mediaFiles: () => call<MediaFileDto[]>("list_media_files"),
  configPath: () => call<string>("config_path"),

  // ---- 密码 ----
  unlock: (password: string) => call<boolean>("unlock", { password }),
  lock: () => call<void>("lock"),
  setPassword: (fresh: string, current?: string) =>
    call<ConfigView>("set_password", { current: current ?? null, fresh }),
  setDiscoveryOpen: (open: boolean) => call<void>("set_discovery_open", { open }),

  // ---- 绑定与身份 ----
  bindCamera: (cameraId: number | null, password?: string) =>
    call<ConfigView>("bind_camera", { cameraId, password: password ?? null }),
  bindArmor: (armorId: number | null, password?: string) =>
    call<ConfigView>("bind_armor", { armorId, password: password ?? null }),
  setTeam: (team: number, password?: string) =>
    call<ConfigView>("set_team", { team, password: password ?? null }),
  setRole: (role: Role, password?: string) =>
    call<ConfigView>("set_role", { role, password: password ?? null }),
  setMirror: (mirror: boolean) => call<ConfigView>("set_mirror", { mirror }),
  saveHud: (hud: HudView) => call<ConfigView>("save_hud", { hud }),
  /** 改一边的队名（0 = 队伍一，1 = 队伍二）。一次只改一边，避免覆盖另一边的改动。 */
  setTeamName: (team: number, name: string, password?: string) =>
    call<ConfigView>("set_team_name", { team, name, password: password ?? null }),
  setRefereeSlots: (slots: {
    cameraA: number | null;
    cameraB: number | null;
    armorA: number | null;
    armorB: number | null;
    manual: boolean;
  }) => call<ConfigView>("set_referee_slots", slots),
  setRecordingOptions: (options: {
    dir: string | null;
    ffmpeg: string | null;
    crf: number | null;
    preset: string | null;
  }) => call<ConfigView>("set_recording_options", options),

  // ---- 截图与录制 ----
  screenshot: (camera: number) => call<string>("screenshot", { camera }),
  startRecording: (cameras: number[]) => call<RecordingDto[]>("start_recording", { cameras }),
  stopRecording: (cameras: number[]) => call<RecordingDto[]>("stop_recording", { cameras }),
  reveal: (path: string) => call<void>("reveal", { path }),
  openFile: (path: string) => call<void>("open_file", { path }),

  // ---- 退出与重置 ----
  clearConfig: (password?: string) =>
    call<string>("clear_config", { password: password ?? null }),
  quit: (password?: string) => call<void>("quit_app", { password: password ?? null }),

  refresh: () => call<void>("refresh"),
};