@foundbyte/uni-agent 1.0.0-alpha.0

package/composables/use-recorder/types.ts

@@ -0,0 +1,73 @@
+/**
+ * 录音相关类型定义
+ * 供 recorder-manager.ts 和 use-recorder.ts 共享使用
+ */
+
+/** 录音停止回调结果（原生平台格式） */
+export interface RecorderStopResult {
+  /** 录音文件的临时路径 */
+  tempFilePath: string
+  /** 录音时长，单位 s（原生平台返回秒） */
+  duration: number
+  /** 录音文件大小，单位 Byte */
+  fileSize: number
+}
+
+/** 录音结果（use-recorder 使用的格式） */
+export interface RecorderResult {
+  /** 录音文件的临时路径 */
+  tempFilePath: string
+  /** 录音时长，单位 ms（转换为毫秒） */
+  duration: number
+  /** 录音文件大小，单位 Byte */
+  fileSize: number
+}
+
+/** 录音错误回调结果 */
+export interface RecorderErrorResult {
+  /** 错误信息 */
+  errMsg: string
+}
+
+/** 录音帧回调结果 */
+export interface RecorderFrameResult {
+  /** 录音帧数据 */
+  frameBuffer: Blob
+  /** 是否最后一帧 */
+  isLastFrame: boolean
+}
+
+/** 开始录音回调函数类型 */
+export type StartCallback = () => void
+
+/** 暂停录音回调函数类型 */
+export type PauseCallback = () => void
+
+/** 继续录音回调函数类型 */
+export type ResumeCallback = () => void
+
+/** 停止录音回调函数类型 */
+export type StopCallback = (result: RecorderStopResult) => void
+
+/** 录音错误回调函数类型 */
+export type ErrorCallback = (error: RecorderErrorResult) => void
+
+/** 录音帧录制回调函数类型 */
+export type FrameRecordedCallback = (result: RecorderFrameResult) => void
+
+/** 录音中断回调函数类型 */
+export type InterruptionCallback = () => void
+
+export type RecorderManagerOptions = UniApp.RecorderManagerStartOptions
+
+/** 回调函数集合 */
+export interface RecorderCallbacks {
+  onStart: Array<() => void>
+  onPause: Array<() => void>
+  onResume: Array<() => void>
+  onStop: Array<(result: RecorderStopResult) => void>
+  onError: Array<(error: RecorderErrorResult) => void>
+  onFrameRecorded: Array<(result: RecorderFrameResult) => void>
+  onInterruptionBegin: Array<() => void>
+  onInterruptionEnd: Array<() => void>
+}

package/composables/use-recorder/use-recorder.ts

@@ -0,0 +1,205 @@
+/* eslint-disable no-restricted-imports */
+import { onUnmounted, ref } from 'vue'
+import { getRecorderManager } from './recorder-manager'
+import type { RecorderManagerOptions, RecorderResult } from './types'
+
+/**
+ * 录音功能 Hooks
+ * @returns 录音控制方法和状态
+ *
+ * @example
+ * const { isRecording, recordingTime, start, stop, cancel } = useRecorder()
+ *
+ * // 开始录音
+ * await start({
+ *   duration: 60000,
+ *   format: 'aac'
+ * })
+ *
+ * // 结束录音并获取结果
+ * const result = await stop()
+ * if (result) {
+ *   console.log('录音文件路径:', result.tempFilePath)
+ *   console.log('录音时长:', result.duration)
+ * }
+ */
+export function useRecorder() {
+  // 录音管理器实例
+  const recorderManager = getRecorderManager()
+
+  // 是否正在录音
+  const isRecording = ref(false)
+
+  // 录音时长（毫秒）
+  const recordingTime = ref(0)
+
+  // 录音计时器
+  let timer: ReturnType<typeof setInterval> | null = null
+
+  // 录音完成的 Promise 解析函数
+  let resolvePromise: ((value: RecorderResult | null) => void) | null = null
+
+  // 录音失败的 Promise 拒绝函数
+  let rejectPromise: ((reason: Error) => void) | null = null
+
+  /**
+   * 开始计时
+   */
+  const startTimer = () => {
+    recordingTime.value = 0
+    timer = setInterval(() => {
+      recordingTime.value += 100
+    }, 100)
+  }
+
+  /**
+   * 停止计时
+   */
+  const stopTimer = () => {
+    if (timer) {
+      clearInterval(timer)
+      timer = null
+    }
+  }
+
+  /**
+   * 录音停止事件处理
+   */
+  recorderManager.onStop((res) => {
+    isRecording.value = false
+    stopTimer()
+
+    if (resolvePromise) {
+      resolvePromise({
+        tempFilePath: res.tempFilePath,
+        duration: res.duration * 1000, // 转换为毫秒
+        fileSize: res.fileSize,
+      })
+      resolvePromise = null
+      rejectPromise = null
+    }
+  })
+
+  /**
+   * 录音错误事件处理
+   */
+  recorderManager.onError((err) => {
+    isRecording.value = false
+    stopTimer()
+
+    console.error('录音错误:', err)
+
+    if (rejectPromise) {
+      rejectPromise(new Error(err.errMsg || '录音发生错误'))
+      resolvePromise = null
+      rejectPromise = null
+    }
+  })
+
+  // 用于标记是否已处理开始回调
+  let startHandled = false
+
+  /**
+   * 开始录音
+   * @param options 录音配置选项
+   */
+  const start = async (options: RecorderManagerOptions = {}): Promise<void> => {
+    if (isRecording.value) {
+      throw new Error('正在录音中，请先停止当前录音')
+    }
+
+    const {
+      duration = 60000,
+      sampleRate = 16000,
+      numberOfChannels = 1,
+      encodeBitRate = 64000,
+      format = 'aac',
+      frameSize,
+    } = options
+
+    return new Promise((resolve, reject) => {
+      startHandled = false
+
+      // 监听录音开始成功事件
+      const onStart = () => {
+        if (startHandled) return
+        startHandled = true
+        isRecording.value = true
+        startTimer()
+        resolve()
+      }
+
+      // 监听录音开始失败事件
+      const onStartError = (err: { errMsg: string }) => {
+        if (startHandled) return
+        startHandled = true
+        reject(new Error(err.errMsg || '启动录音失败'))
+      }
+
+      // 使用 once 方式监听，通过标志位防止重复触发
+      recorderManager.onStart(onStart)
+      recorderManager.onError(onStartError)
+
+      // 开始录音
+      recorderManager.start({
+        duration,
+        sampleRate,
+        numberOfChannels,
+        encodeBitRate,
+        format,
+        frameSize,
+      })
+    })
+  }
+
+  /**
+   * 结束录音
+   * @returns 录音结果，包含临时文件路径、时长和文件大小
+   */
+  const stop = async (): Promise<RecorderResult | null> => {
+    if (!isRecording.value) {
+      console.warn('当前没有在录音')
+      return null
+    }
+
+    return new Promise((resolve, reject) => {
+      resolvePromise = resolve
+      rejectPromise = reject
+      recorderManager.stop()
+    })
+  }
+
+  /**
+   * 取消录音
+   */
+  const cancel = (): void => {
+    if (!isRecording.value) {
+      return
+    }
+
+    // 设置标志，让 onStop 回调返回 null
+    resolvePromise = () => {
+      // 取消时返回 null
+    }
+
+    stopTimer()
+    isRecording.value = false
+    recorderManager.stop()
+  }
+
+  // 组件卸载时清理资源
+  onUnmounted(() => {
+    stopTimer()
+    if (isRecording.value) {
+      recorderManager.stop()
+    }
+  })
+
+  return {
+    isRecording,
+    recordingTime,
+    start,
+    stop,
+    cancel,
+  }
+}

package/configs/index.ts

@@ -0,0 +1,5 @@
+/** 静态资源前缀 */
+export const staticPrefix =
+  'https://object.onetravelgz.com.cn/onecode-travel/frontEnd/miniprogram/ticket-agent'
+
+export const cssPrefix = 'ua'

package/index.ts

@@ -0,0 +1,3 @@
+export * from './components'
+export * from './composables'
+export * from './configs'

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@foundbyte/uni-agent",
+  "version": "1.0.0-alpha.0",
+  "private": false,
+  "type": "module",
+  "main": "index.ts",
+  "module": "index.ts",
+  "browser": "index.ts",
+  "types": "index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "HBuilderX": "^4.07",
+    "uni-app": "^4.07",
+    "uni-app-x": ""
+  },
+  "uni_modules": {
+    "dependencies": [],
+    "encrypt": [],
+    "platforms": {
+      "cloud": {
+        "tcb": "√",
+        "aliyun": "√",
+        "alipay": "√"
+      },
+      "client": {
+        "uni-app": {
+          "vue": {
+            "vue2": "x",
+            "vue3": "√"
+          },
+          "web": {
+            "safari": "√",
+            "chrome": "√"
+          },
+          "app": {
+            "vue": "√",
+            "nvue": "-",
+            "android": "√",
+            "ios": "√",
+            "harmony": "√"
+          },
+          "mp": {
+            "weixin": "√",
+            "alipay": "√",
+            "toutiao": "√",
+            "baidu": "-",
+            "kuaishou": "-",
+            "jd": "-",
+            "harmony": "√",
+            "qq": "√",
+            "lark": "-",
+            "xhs": "-"
+          },
+          "quickapp": {
+            "huawei": "-",
+            "union": "-"
+          }
+        },
+        "uni-app-x": {
+          "web": {
+            "safari": "-",
+            "chrome": "-"
+          },
+          "app": {
+            "android": "-",
+            "ios": "-",
+            "harmony": "-"
+          },
+          "mp": {
+            "weixin": "-"
+          }
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "vue": "3.5.30",
+    "@foundbyte/uni-types": "^1.0.0",
+    "@foundbyte/uni-utils": "^1.1.0"
+  },
+  "devDependencies": {
+    "@dcloudio/types": "3.4.30"
+  },
+  "scripts": {
+    "publish:npm": "pnpm publish",
+    "sync:sync": "cnpm sync @foundbyte/uni-agent"
+  }
+}

package/styles/_base.scss

@@ -0,0 +1,8 @@
+// 库前缀
+$prefix: 'ua';
+// 基础字体
+$font-size-base: 28rpx;
+// 大字体
+$font-size-large: 32rpx;
+// 小字体
+$font-size-small: 24rpx;