@ayden-fc2/riffle-bridge-web 1.0.0

package/src/controllers/index.ts

@@ -0,0 +1,527 @@
+/**
+ * Riffle Bridge 控制器模块
+ */
+
+import type { BridgeCore } from '../core';
+import type {
+  HapticFeedbackType,
+  SensorType,
+  SensorData,
+  BarometerData,
+  DeviceInfo,
+  BatteryInfo,
+  NetworkInfo,
+  SystemInfo,
+  AppInfo,
+  ScreenInfo,
+  StorageStats,
+  FileInfo,
+  CachedFileInfo,
+  DownloadResult,
+  Base64Result,
+  PhotoResult,
+  AudioStatus,
+  CameraFacing,
+  CameraFilter,
+  RecordingResult,
+  PermissionResult,
+  VolumeData,
+} from '../types';
+
+// ============================================
+// 震动控制器
+// ============================================
+
+export class HapticController {
+  constructor(private core: BridgeCore) {}
+
+  async light(): Promise<void> {
+    await this.core.send('haptic', 'light');
+  }
+
+  async medium(): Promise<void> {
+    await this.core.send('haptic', 'medium');
+  }
+
+  async heavy(): Promise<void> {
+    await this.core.send('haptic', 'heavy');
+  }
+
+  async success(): Promise<void> {
+    await this.core.send('haptic', 'success');
+  }
+
+  async warning(): Promise<void> {
+    await this.core.send('haptic', 'warning');
+  }
+
+  async error(): Promise<void> {
+    await this.core.send('haptic', 'error');
+  }
+
+  async selection(): Promise<void> {
+    await this.core.send('haptic', 'selection');
+  }
+
+  /**
+   * 播放震动序列
+   */
+  async sequence(types: HapticFeedbackType[], interval = 200): Promise<void> {
+    for (let i = 0; i < types.length; i++) {
+      const type = types[i];
+      const method = this[type as keyof this];
+      if (typeof method === 'function') {
+        await (method as () => Promise<void>).call(this);
+      }
+      if (i < types.length - 1) {
+        await new Promise((resolve) => setTimeout(resolve, interval));
+      }
+    }
+  }
+
+  /**
+   * 根据强度震动
+   */
+  async intensity(level: number): Promise<void> {
+    if (level <= 0.3) return this.light();
+    if (level <= 0.7) return this.medium();
+    return this.heavy();
+  }
+}
+
+// ============================================
+// 传感器控制器
+// ============================================
+
+export interface SensorStartOptions {
+  types?: SensorType[];
+  interval?: number;
+}
+
+export class SensorController {
+  private isActive = false;
+  private activeTypes: SensorType[] = [];
+
+  constructor(private core: BridgeCore) {}
+
+  /**
+   * 启动传感器
+   */
+  async start(options: SensorStartOptions = {}): Promise<{ started: SensorType[]; updateInterval: number }> {
+    const { 
+      types = ['accelerometer', 'gyroscope', 'magnetometer', 'barometer'], 
+      interval = 100 
+    } = options;
+
+    const result = await this.core.send<{ started: SensorType[]; updateInterval: number }>(
+      'sensors', 
+      'start', 
+      { types, updateInterval: interval }
+    );
+
+    this.isActive = true;
+    this.activeTypes = types;
+    return result;
+  }
+
+  /**
+   * 停止传感器
+   */
+  async stop(): Promise<{ stopped: boolean }> {
+    const result = await this.core.send<{ stopped: boolean }>('sensors', 'stop');
+    this.isActive = false;
+    this.activeTypes = [];
+    return result;
+  }
+
+  /**
+   * 监听加速度计数据
+   */
+  onAccelerometer(callback: (data: SensorData[]) => void): () => void {
+    return this.core.onSensorData('accelerometer', callback as (data: unknown[]) => void);
+  }
+
+  /**
+   * 监听陀螺仪数据
+   */
+  onGyroscope(callback: (data: SensorData[]) => void): () => void {
+    return this.core.onSensorData('gyroscope', callback as (data: unknown[]) => void);
+  }
+
+  /**
+   * 监听磁力计数据
+   */
+  onMagnetometer(callback: (data: SensorData[]) => void): () => void {
+    return this.core.onSensorData('magnetometer', callback as (data: unknown[]) => void);
+  }
+
+  /**
+   * 监听气压计数据
+   */
+  onBarometer(callback: (data: BarometerData[]) => void): () => void {
+    return this.core.onSensorData('barometer', callback as (data: unknown[]) => void);
+  }
+
+  /**
+   * 获取当前状态
+   */
+  getStatus(): { isActive: boolean; activeTypes: SensorType[] } {
+    return { isActive: this.isActive, activeTypes: this.activeTypes };
+  }
+}
+
+// ============================================
+// 设备信息控制器
+// ============================================
+
+export class DeviceController {
+  constructor(private core: BridgeCore) {}
+
+  async getDeviceInfo(): Promise<DeviceInfo> {
+    return this.core.send<DeviceInfo>('device', 'getDeviceInfo');
+  }
+
+  async getBatteryInfo(): Promise<BatteryInfo> {
+    return this.core.send<BatteryInfo>('device', 'getBatteryInfo');
+  }
+
+  async getNetworkInfo(): Promise<NetworkInfo> {
+    return this.core.send<NetworkInfo>('device', 'getNetworkInfo');
+  }
+
+  async getSystemInfo(): Promise<SystemInfo> {
+    return this.core.send<SystemInfo>('device', 'getSystemInfo');
+  }
+
+  async getAppInfo(): Promise<AppInfo> {
+    return this.core.send<AppInfo>('device', 'getAppInfo');
+  }
+
+  async getScreenInfo(): Promise<ScreenInfo> {
+    return this.core.send<ScreenInfo>('device', 'getScreenInfo');
+  }
+
+  async getAllInfo(): Promise<{
+    device: Partial<DeviceInfo>;
+    battery: Partial<BatteryInfo>;
+    network: Partial<NetworkInfo>;
+    system: Partial<SystemInfo>;
+    app: Partial<AppInfo>;
+  }> {
+    return this.core.send('device', 'getAllInfo');
+  }
+}
+
+// ============================================
+// 文件存储控制器
+// ============================================
+
+export class FileStorageController {
+  constructor(private core: BridgeCore) {}
+
+  async init(): Promise<{ initialized: boolean }> {
+    return this.core.send('fileStorage', 'init');
+  }
+
+  async getStorageStats(): Promise<StorageStats> {
+    return this.core.send<StorageStats>('fileStorage', 'getStorageStats');
+  }
+
+  async takePhoto(): Promise<FileInfo> {
+    return this.core.send<FileInfo>('fileStorage', 'takePhoto');
+  }
+
+  async pickFromGallery(): Promise<FileInfo> {
+    return this.core.send<FileInfo>('fileStorage', 'pickFromGallery');
+  }
+
+  async saveFile(sourceUri: string, filename: string, subfolder?: string): Promise<FileInfo> {
+    return this.core.send<FileInfo>('fileStorage', 'saveFile', {
+      sourceUri,
+      filename,
+      subfolder,
+    });
+  }
+
+  async listFiles(subfolder?: string): Promise<FileInfo[]> {
+    return this.core.send<FileInfo[]>('fileStorage', 'listFiles', { subfolder });
+  }
+
+  async downloadAndSave(url: string, filename: string, subfolder?: string): Promise<FileInfo> {
+    return this.core.send<FileInfo>('fileStorage', 'downloadAndSave', {
+      url,
+      downloadFilename: filename,
+      downloadSubfolder: subfolder,
+    });
+  }
+
+  async getLocalFileByUrl(url: string): Promise<CachedFileInfo> {
+    return this.core.send<CachedFileInfo>('fileStorage', 'getLocalFileByUrl', {
+      checkUrl: url,
+    });
+  }
+
+  async clearAppFiles(): Promise<{ cleared: boolean }> {
+    return this.core.send('fileStorage', 'clearAppFiles');
+  }
+
+  async deleteFile(filename: string, subfolder?: string): Promise<{ deleted: boolean }> {
+    return this.core.send('fileStorage', 'deleteFile', {
+      deleteFilename: filename,
+      deleteSubfolder: subfolder,
+    });
+  }
+
+  async loadUrlMappings(): Promise<Array<{ url: string; filename: string; path: string }>> {
+    return this.core.send('fileStorage', 'loadUrlMappings');
+  }
+
+  async downloadWithCache(url: string, checkCache = true): Promise<DownloadResult> {
+    return this.core.send<DownloadResult>('fileStorage', 'downloadWithCache', {
+      downloadUrl: url,
+      checkCache,
+    });
+  }
+
+  async clearUrlMappings(): Promise<{ cleared: boolean }> {
+    return this.core.send('fileStorage', 'clearUrlMappings');
+  }
+
+  async removeUrlMapping(url: string): Promise<{ removed: boolean }> {
+    return this.core.send('fileStorage', 'removeUrlMapping', { removeUrl: url });
+  }
+
+  async addCustomFileMapping(customKey: string, localUri: string): Promise<{ added: boolean }> {
+    return this.core.send('fileStorage', 'addCustomFileMapping', {
+      customKey,
+      localPath: localUri,
+    });
+  }
+
+  async readAsBase64(uriOrKey: string): Promise<Base64Result> {
+    return this.core.send<Base64Result>('fileStorage', 'readAsBase64', { uriOrKey });
+  }
+}
+
+// ============================================
+// 音频控制器
+// ============================================
+
+export interface PlayOptions {
+  uri: string;
+  volume?: number;
+  rate?: number;
+  isLooping?: boolean;
+}
+
+export class AudioController {
+  constructor(
+    private core: BridgeCore,
+    private fileStorage: FileStorageController
+  ) {}
+
+  /**
+   * 解析 URI，返回可播放的实际路径
+   */
+  private async resolveUri(uri: string): Promise<string> {
+    if (!uri) throw new Error('URI is required');
+
+    // file:// 协议直接使用
+    if (uri.startsWith('file://')) {
+      return uri;
+    }
+
+    // 非 http/https 协议，从 MAP 查询
+    if (!uri.startsWith('http://') && !uri.startsWith('https://')) {
+      const cached = await this.fileStorage.getLocalFileByUrl(uri);
+      if (cached?.exists && cached.uri) {
+        return cached.uri;
+      }
+      throw new Error(`File mapping not found: ${uri}`);
+    }
+
+    // http/https URL，先查缓存
+    try {
+      const cached = await this.fileStorage.getLocalFileByUrl(uri);
+      if (cached?.exists && cached.uri) {
+        return cached.uri;
+      }
+    } catch {
+      // 查询失败，继续使用在线 URL
+    }
+
+    return uri;
+  }
+
+  /**
+   * 播放音频（智能解析 URI）
+   */
+  async playOnline(options: PlayOptions): Promise<{ playing: boolean; uri: string }> {
+    const { uri, ...playOptions } = options;
+
+    let resolvedUri = await this.resolveUri(uri);
+
+    // 在线 URL 未缓存时，先下载
+    if (uri.startsWith('http') && resolvedUri === uri) {
+      try {
+        const downloadResult = await this.fileStorage.downloadWithCache(uri);
+        if (downloadResult?.uri) {
+          resolvedUri = downloadResult.uri;
+        }
+      } catch (e) {
+        console.warn('[AudioController] Cache failed, using online URL:', e);
+      }
+    }
+
+    return this.core.send('audio', 'playOnline', {
+      ...playOptions,
+      uri: resolvedUri,
+    });
+  }
+
+  async pause(): Promise<{ paused: boolean }> {
+    return this.core.send('audio', 'pause');
+  }
+
+  async resume(): Promise<{ resumed: boolean }> {
+    return this.core.send('audio', 'resume');
+  }
+
+  async stop(): Promise<{ stopped: boolean }> {
+    return this.core.send('audio', 'stop');
+  }
+
+  async setVolume(volume: number): Promise<{ volume: number }> {
+    return this.core.send('audio', 'setVolume', { volume });
+  }
+
+  async setRate(rate: number): Promise<{ rate: number }> {
+    return this.core.send('audio', 'setRate', { rate });
+  }
+
+  async getStatus(): Promise<AudioStatus> {
+    return this.core.send<AudioStatus>('audio', 'getStatus');
+  }
+}
+
+// ============================================
+// 相机控制器
+// ============================================
+
+export class CameraController {
+  constructor(private core: BridgeCore) {}
+
+  async open(options: { facing?: CameraFacing } = {}): Promise<{ isOpen: boolean; facing: CameraFacing }> {
+    const { facing = 'back' } = options;
+    return this.core.send('camera', 'open', { facing });
+  }
+
+  async close(): Promise<{ isOpen: boolean }> {
+    return this.core.send('camera', 'close');
+  }
+
+  async toggleFacing(): Promise<{ facing: CameraFacing }> {
+    return this.core.send('camera', 'toggleFacing');
+  }
+
+  async takePhoto(): Promise<PhotoResult> {
+    return this.core.send<PhotoResult>('camera', 'takePhoto');
+  }
+
+  async setFilter(filter: CameraFilter): Promise<{ filter: string; customStyles?: Record<string, unknown> }> {
+    return this.core.send('camera', 'setFilter', { filter });
+  }
+
+  async setFlash(enabled: boolean): Promise<{ flash: boolean }> {
+    return this.core.send('camera', 'setFlash', { enabled });
+  }
+
+  async toggleFlash(): Promise<{ flash: boolean }> {
+    return this.core.send('camera', 'toggleFlash');
+  }
+}
+
+// ============================================
+// 麦克风控制器
+// ============================================
+
+export class MicrophoneController {
+  private isRecording = false;
+
+  constructor(private core: BridgeCore) {}
+
+  async requestPermission(): Promise<PermissionResult> {
+    return this.core.send<PermissionResult>('microphone', 'requestPermission');
+  }
+
+  async start(options: { enableMonitoring?: boolean } = {}): Promise<RecordingResult> {
+    const { enableMonitoring = true } = options;
+    const result = await this.core.send<RecordingResult>('microphone', 'start', {
+      enableMonitoring,
+    });
+    this.isRecording = true;
+    return result;
+  }
+
+  async stop(): Promise<RecordingResult> {
+    const result = await this.core.send<RecordingResult>('microphone', 'stop');
+    this.isRecording = false;
+    return result;
+  }
+
+  async pause(): Promise<{ paused: boolean }> {
+    return this.core.send('microphone', 'pause');
+  }
+
+  async resume(): Promise<{ resumed: boolean }> {
+    return this.core.send('microphone', 'resume');
+  }
+
+  async getStatus(): Promise<{
+    isRecording: boolean;
+    isDoneRecording?: boolean;
+    durationMillis?: number;
+    canRecord: boolean;
+  }> {
+    return this.core.send('microphone', 'getStatus');
+  }
+
+  /**
+   * 监听音量数据
+   */
+  onVolumeData(callback: (data: VolumeData[]) => void): () => void {
+    return this.core.onSensorData('microphone_volume', callback as (data: unknown[]) => void);
+  }
+
+  getRecordingState(): boolean {
+    return this.isRecording;
+  }
+}
+
+// ============================================
+// 配置控制器
+// ============================================
+
+export class ConfigController {
+  private currentConfig: Record<string, unknown> | null = null;
+
+  constructor(private core: BridgeCore) {}
+
+  async updateParams(configData: Record<string, unknown>): Promise<{
+    received: boolean;
+    configId: number;
+    dataKeys: string[];
+    message: string;
+  }> {
+    this.currentConfig = configData;
+    return this.core.send('config', 'updateParams', configData);
+  }
+
+  getCurrentConfig(): Record<string, unknown> | null {
+    return this.currentConfig;
+  }
+
+  async resetToDefaults(): Promise<{ reset: boolean }> {
+    return this.core.send('config', 'resetToDefaults');
+  }
+}