@tiny-codes/react-easy 1.4.6 → 1.4.8

package/lib/hooks/index.js

@@ -16,6 +16,7 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
   // If the importer is in node compatibility mode or this is not an ESM
   // file that has been converted to a CommonJS file using a Babel-
@@ -31,6 +32,8 @@ var hooks_exports = {};
 __export(hooks_exports, {
   useRefFunction: () => import_useRefFunction.default,
   useRefValue: () => import_useRefValue.default,
+  useStompSocket: () => import_useStompSocket.default,
+  useUserMedia: () => import_useUserMedia.default,
   useValidator: () => import_useValidator.default,
   useValidatorBuilder: () => import_useValidatorBuilder.default,
   useValidators: () => import_useValidators.default
@@ -38,15 +41,23 @@ __export(hooks_exports, {
 module.exports = __toCommonJS(hooks_exports);
 var import_useRefValue = __toESM(require("./useRefValue"));
 var import_useRefFunction = __toESM(require("./useRefFunction"));
+__reExport(hooks_exports, require("./useStompSocket"), module.exports);
+var import_useStompSocket = __toESM(require("./useStompSocket"));
 var import_useValidators = __toESM(require("./useValidators"));
 var import_useValidator = __toESM(require("./useValidator"));
 var import_useValidatorBuilder = __toESM(require("./useValidatorBuilder"));
+__reExport(hooks_exports, require("./useUserMedia"), module.exports);
+var import_useUserMedia = __toESM(require("./useUserMedia"));
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   useRefFunction,
   useRefValue,
+  useStompSocket,
+  useUserMedia,
   useValidator,
   useValidatorBuilder,
-  useValidators
+  useValidators,
+  ...require("./useStompSocket"),
+  ...require("./useUserMedia")
 });
 //# sourceMappingURL=index.js.map

package/lib/hooks/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/hooks/index.ts"],
-  "sourcesContent": ["export { default as useRefValue } from './useRefValue';\nexport { default as useRefFunction } from './useRefFunction';\n\nexport type { ValidatorRuleMap } from './useValidators';\nexport { default as useValidators } from './useValidators';\nexport { default as useValidator } from './useValidator';\nexport type { Validator, RuleRegExpFlags, ValidatorRule, BuilderOptions } from './useValidatorBuilder';\nexport { default as useValidatorBuilder } from './useValidatorBuilder';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAuC;AACvC,4BAA0C;AAG1C,2BAAyC;AACzC,0BAAwC;AAExC,iCAA+C;",
+  "sourcesContent": ["export { default as useRefValue } from './useRefValue';\nexport { default as useRefFunction } from './useRefFunction';\nexport * from './useStompSocket';\nexport { default as useStompSocket } from './useStompSocket';\nexport type { ValidatorRuleMap } from './useValidators';\nexport { default as useValidators } from './useValidators';\nexport { default as useValidator } from './useValidator';\nexport type { Validator, RuleRegExpFlags, ValidatorRule, BuilderOptions } from './useValidatorBuilder';\nexport { default as useValidatorBuilder } from './useValidatorBuilder';\nexport * from './useUserMedia';\nexport { default as useUserMedia } from './useUserMedia';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAuC;AACvC,4BAA0C;AAC1C,0BAAc,6BAFd;AAGA,4BAA0C;AAE1C,2BAAyC;AACzC,0BAAwC;AAExC,iCAA+C;AAC/C,0BAAc,2BATd;AAUA,0BAAwC;",
   "names": []
 }

package/lib/hooks/useRefValue.d.ts

@@ -1,4 +1,4 @@
-import type { RefObject } from 'react';
+import type { MutableRefObject } from 'react';
 /**
  * - **EN:** Get a mutable ref object and automatically update the value change
  * - **CN:** 获取一个可变的ref对象，并自动更新值变化
@@ -7,5 +7,5 @@ import type { RefObject } from 'react';
  *
  * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变
  */
-declare const useRefValue: <T>(value: T) => RefObject<T>;
+declare const useRefValue: <T>(value: T) => MutableRefObject<T>;
 export default useRefValue;

package/lib/hooks/useRefValue.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/hooks/useRefValue.ts"],
-  "sourcesContent": ["import type { RefObject } from 'react';\nimport { useRef } from 'react';\n\n/**\n * - **EN:** Get a mutable ref object and automatically update the value change\n * - **CN:** 获取一个可变的ref对象，并自动更新值变化\n *\n * @param value the wrapped value | 被包装的值\n *\n * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变\n */\nconst useRefValue = <T>(value: T): RefObject<T> => {\n  const ref = useRef<T>(value);\n  ref.current = value;\n  return ref;\n};\n\nexport default useRefValue;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAuB;AAUvB,IAAM,cAAc,CAAI,UAA2B;AACjD,QAAM,UAAM,qBAAU,KAAK;AAC3B,MAAI,UAAU;AACd,SAAO;AACT;AAEA,IAAO,sBAAQ;",
+  "sourcesContent": ["import type { MutableRefObject } from 'react';\nimport { useRef } from 'react';\n\n/**\n * - **EN:** Get a mutable ref object and automatically update the value change\n * - **CN:** 获取一个可变的ref对象，并自动更新值变化\n *\n * @param value the wrapped value | 被包装的值\n *\n * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变\n */\nconst useRefValue = <T>(value: T): MutableRefObject<T> => {\n  const ref = useRef<T>(value);\n  ref.current = value;\n  return ref;\n};\n\nexport default useRefValue;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAuB;AAUvB,IAAM,cAAc,CAAI,UAAkC;AACxD,QAAM,UAAM,qBAAU,KAAK;AAC3B,MAAI,UAAU;AACd,SAAO;AACT;AAEA,IAAO,sBAAQ;",
   "names": []
 }

package/lib/hooks/useStompSocket.d.ts

@@ -0,0 +1,63 @@
+import type { StompConfig } from '@stomp/stompjs';
+import { Client } from '@stomp/stompjs';
+export interface UseSocketOptions<M = string> {
+    /**
+     * - **EN:** Socket connection address
+     * - **CN:** Socket连接地址
+     */
+    url: string;
+    /**
+     * - **EN:** STOMP connection configuration
+     * - **CN:** - **CN:** STOMP连接配置
+     */
+    connectConfig?: StompConfig;
+    /**
+     * - **EN:** Channel path for publishing messages
+     * - **CN:** 发布消息的频道路径
+     */
+    sendEndpoint?: string;
+    /**
+     * - **EN:** Endpoint path for receiving messages
+     * - **CN:** 接收消息的端点路径
+     */
+    subscribeEndpoint?: string;
+    /**
+     * - **EN:** Connection success callback
+     * - **CN:** 连接成功回调
+     */
+    onConnected?: () => void;
+    /**
+     * - **EN:** Message received callback
+     * - **CN:** 接收到消息回调
+     */
+    onMessage?: (message: M) => void;
+    /**
+     * - **EN:** Parse message body, return value as input parameter for `onMessage`
+     * - **CN:** 解析消息体，返回值作为`onMessage`的输入参数。
+     *
+     * @param body - The raw message body received from the server, needs to be deserialized based on
+     *   actual conditions. | 从服务端接收到的原始消息体，需要根据实际情况进行反序列化。
+     *
+     * @returns Parsed message body as the input parameter of `onMessage`| 解析后的消息体，作为`onMessage`的输入参数
+     */
+    parseMessageBody?: (body: string) => M;
+    /**
+     * - **EN:** Connection close callback
+     * - **CN:** 连接关闭回调
+     */
+    onClose?: () => void;
+}
+/**
+ * - **EN:** Establish a WebSocket based on the STOMP protocol, mainly used for bidirectional
+ *   transmission of serializable character messages.
+ * - **CN:** 建立基于STOMP协议的WebSocket，主要用于双向传递可序列化的字符型消息
+ */
+declare function useStompSocket<M = string>(options: UseSocketOptions<M>): {
+    connect: () => Promise<void>;
+    close: () => void;
+    send: (body: string) => void;
+    connecting: boolean;
+    socket: WebSocket | undefined;
+    stompClient: Client | undefined;
+};
+export default useStompSocket;

package/lib/hooks/useStompSocket.js

@@ -0,0 +1,154 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/useStompSocket.ts
+var useStompSocket_exports = {};
+__export(useStompSocket_exports, {
+  default: () => useStompSocket_default
+});
+module.exports = __toCommonJS(useStompSocket_exports);
+var import_react = require("react");
+var import_stompjs = require("@stomp/stompjs");
+var import_antd = require("antd");
+var import_sockjs_client = __toESM(require("sockjs-client"));
+var import_useRefFunction = __toESM(require("./useRefFunction"));
+var import_useT = __toESM(require("./useT"));
+function useStompSocket(options) {
+  const { url, sendEndpoint, subscribeEndpoint, connectConfig, onMessage, parseMessageBody, onConnected, onClose } = options;
+  const t = (0, import_useT.default)();
+  const socketRef = (0, import_react.useRef)(void 0);
+  const stompClientRef = (0, import_react.useRef)(void 0);
+  const [connecting, setConnecting] = (0, import_react.useState)(false);
+  const isConnectedRef = (0, import_react.useRef)(false);
+  const [, refresh] = (0, import_react.useState)();
+  const connect = (0, import_useRefFunction.default)(async () => {
+    const promise = new Promise((resolve, reject) => {
+      try {
+        setConnecting(true);
+        socketRef.current = new import_sockjs_client.default(url);
+        stompClientRef.current = new import_stompjs.Client({
+          heartbeatIncoming: 5e3,
+          heartbeatOutgoing: 5e3,
+          ...connectConfig,
+          webSocketFactory: () => socketRef.current
+        });
+        stompClientRef.current.activate();
+        stompClientRef.current.onConnect = () => {
+          var _a;
+          setConnecting(false);
+          isConnectedRef.current = true;
+          onConnected == null ? void 0 : onConnected();
+          if (subscribeEndpoint) {
+            (_a = stompClientRef.current) == null ? void 0 : _a.subscribe(subscribeEndpoint, (response) => {
+              if (parseMessageBody) {
+                onMessage == null ? void 0 : onMessage(parseMessageBody(response.body));
+              } else {
+                onMessage == null ? void 0 : onMessage(response.body);
+              }
+            });
+          }
+          resolve();
+        };
+        stompClientRef.current.onStompError = (error) => {
+          console.error("STOMP Error:", error);
+        };
+        stompClientRef.current.onWebSocketError = (error) => {
+          console.error("WebSocket Error:", error);
+        };
+        if (socketRef.current) {
+          socketRef.current.onerror = (error) => {
+            console.error(error);
+          };
+        }
+        stompClientRef.current.onWebSocketClose = (event) => {
+          var _a;
+          setConnecting(false);
+          if (event.type === "close" && event.code === 1e3) {
+            return;
+          }
+          (_a = stompClientRef.current) == null ? void 0 : _a.debug("StompClient closed");
+          if (isConnectedRef.current) {
+            isConnectedRef.current = false;
+            onClose == null ? void 0 : onClose();
+            import_antd.notification.error({ message: void 0, description: t("hooks.useStompSocket.serverDisconnected") });
+          } else {
+            import_antd.notification.error({ message: t("hooks.useStompSocket.connectError") });
+          }
+        };
+        if (socketRef.current) {
+          socketRef.current.onclose = (event) => {
+            var _a;
+            setConnecting(false);
+            isConnectedRef.current = false;
+            (_a = stompClientRef.current) == null ? void 0 : _a.debug("Socket closed");
+            console.log("event", event);
+            onClose == null ? void 0 : onClose();
+          };
+        }
+      } catch (error) {
+        console.error(error);
+        reject(error);
+      }
+    });
+    refresh();
+    await new Promise((resolve) => setTimeout(resolve));
+    return promise;
+  });
+  const close = (0, import_useRefFunction.default)(() => {
+    var _a, _b;
+    try {
+      (_a = stompClientRef.current) == null ? void 0 : _a.deactivate();
+      (_b = socketRef.current) == null ? void 0 : _b.close();
+      isConnectedRef.current = false;
+      setConnecting(false);
+    } catch (error) {
+      console.error(error);
+    }
+  });
+  const send = (0, import_useRefFunction.default)((body) => {
+    var _a;
+    if (!sendEndpoint) {
+      console.error("No publish endpoint defined, unable to send message");
+      return;
+    }
+    (_a = stompClientRef.current) == null ? void 0 : _a.publish({
+      destination: sendEndpoint,
+      body
+    });
+  });
+  return {
+    connect,
+    close,
+    send,
+    connecting,
+    socket: socketRef.current,
+    stompClient: stompClientRef.current
+  };
+}
+var useStompSocket_default = useStompSocket;
+//# sourceMappingURL=useStompSocket.js.map

package/lib/hooks/useStompSocket.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/useStompSocket.ts"],
+  "sourcesContent": ["import { useRef, useState } from 'react';\nimport type { StompConfig } from '@stomp/stompjs';\nimport { Client } from '@stomp/stompjs';\nimport { notification } from 'antd';\nimport SockJS from 'sockjs-client';\nimport useRefFunction from './useRefFunction';\nimport useT from './useT';\n\nexport interface UseSocketOptions<M = string> {\n  /**\n   * - **EN:** Socket connection address\n   * - **CN:** Socket连接地址\n   */\n  url: string;\n  /**\n   * - **EN:** STOMP connection configuration\n   * - **CN:** - **CN:** STOMP连接配置\n   */\n  connectConfig?: StompConfig;\n  /**\n   * - **EN:** Channel path for publishing messages\n   * - **CN:** 发布消息的频道路径\n   */\n  sendEndpoint?: string;\n  /**\n   * - **EN:** Endpoint path for receiving messages\n   * - **CN:** 接收消息的端点路径\n   */\n  subscribeEndpoint?: string;\n  /**\n   * - **EN:** Connection success callback\n   * - **CN:** 连接成功回调\n   */\n  onConnected?: () => void;\n  /**\n   * - **EN:** Message received callback\n   * - **CN:** 接收到消息回调\n   */\n  onMessage?: (message: M) => void;\n  /**\n   * - **EN:** Parse message body, return value as input parameter for `onMessage`\n   * - **CN:** 解析消息体，返回值作为`onMessage`的输入参数。\n   *\n   * @param body - The raw message body received from the server, needs to be deserialized based on\n   *   actual conditions. | 从服务端接收到的原始消息体，需要根据实际情况进行反序列化。\n   *\n   * @returns Parsed message body as the input parameter of `onMessage`| 解析后的消息体，作为`onMessage`的输入参数\n   */\n  parseMessageBody?: (body: string) => M;\n  /**\n   * - **EN:** Connection close callback\n   * - **CN:** 连接关闭回调\n   */\n  onClose?: () => void;\n}\n\n/**\n * - **EN:** Establish a WebSocket based on the STOMP protocol, mainly used for bidirectional\n *   transmission of serializable character messages.\n * - **CN:** 建立基于STOMP协议的WebSocket，主要用于双向传递可序列化的字符型消息\n */\nfunction useStompSocket<M = string>(options: UseSocketOptions<M>) {\n  const { url, sendEndpoint, subscribeEndpoint, connectConfig, onMessage, parseMessageBody, onConnected, onClose } =\n    options;\n  const t = useT();\n  const socketRef = useRef<WebSocket | undefined>(undefined);\n  const stompClientRef = useRef<Client | undefined>(undefined);\n  const [connecting, setConnecting] = useState(false);\n  const isConnectedRef = useRef(false);\n  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n  const [, refresh] = useState<void>();\n\n  const connect = useRefFunction(async () => {\n    const promise = new Promise<void>((resolve, reject) => {\n      try {\n        setConnecting(true);\n        // Create SockJS instance\n        socketRef.current = new SockJS(url);\n\n        // Create STOMP client\n        stompClientRef.current = new Client({\n          heartbeatIncoming: 5000,\n          heartbeatOutgoing: 5000,\n          ...connectConfig,\n          webSocketFactory: () => socketRef.current,\n        });\n        // Connect to STOMP server\n        stompClientRef.current.activate();\n\n        // STOMP server connection established\n        stompClientRef.current.onConnect = () => {\n          setConnecting(false);\n          isConnectedRef.current = true;\n          onConnected?.();\n          if (subscribeEndpoint) {\n            stompClientRef.current?.subscribe(subscribeEndpoint, (response) => {\n              if (parseMessageBody) {\n                onMessage?.(parseMessageBody(response.body));\n              } else {\n                onMessage?.(response.body as M);\n              }\n            });\n          }\n          resolve();\n        };\n        stompClientRef.current.onStompError = (error) => {\n          console.error('STOMP Error:', error);\n        };\n        stompClientRef.current.onWebSocketError = (error) => {\n          console.error('WebSocket Error:', error);\n        };\n        if (socketRef.current) {\n          socketRef.current.onerror = (error: unknown) => {\n            console.error(error);\n          };\n        }\n\n        stompClientRef.current.onWebSocketClose = (event) => {\n          setConnecting(false);\n          // Normal close\n          if (event.type === 'close' && event.code === 1000) {\n            return;\n          }\n          stompClientRef.current?.debug('StompClient closed');\n          if (isConnectedRef.current) {\n            isConnectedRef.current = false;\n            onClose?.();\n            notification.error({ message: undefined, description: t('hooks.useStompSocket.serverDisconnected') });\n          } else {\n            // Client connection failed\n            notification.error({ message: t('hooks.useStompSocket.connectError') });\n          }\n        };\n        if (socketRef.current) {\n          socketRef.current.onclose = (event) => {\n            setConnecting(false);\n            isConnectedRef.current = false;\n            stompClientRef.current?.debug('Socket closed');\n            console.log('event', event);\n            onClose?.();\n          };\n        }\n      } catch (error: unknown) {\n        console.error(error);\n        // notification.error({ message: error?.message ?? JSON.stringify(error) });\n        reject(error);\n      }\n    });\n    refresh();\n    await new Promise((resolve) => setTimeout(resolve));\n    return promise;\n  });\n  const close = useRefFunction(() => {\n    try {\n      stompClientRef.current?.deactivate();\n      socketRef.current?.close();\n      isConnectedRef.current = false;\n      setConnecting(false);\n    } catch (error) {\n      console.error(error);\n    }\n  });\n  const send = useRefFunction((body: string) => {\n    if (!sendEndpoint) {\n      console.error('No publish endpoint defined, unable to send message');\n      return;\n    }\n    stompClientRef.current?.publish({\n      destination: sendEndpoint,\n      body,\n    });\n  });\n  return {\n    connect,\n    close,\n    send,\n    connecting,\n    socket: socketRef.current,\n    stompClient: stompClientRef.current,\n  };\n}\n\nexport default useStompSocket;\n"],
+  "mappings": "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",
+  "names": ["useT", "useRefFunction", "SockJS"]
+}

package/lib/hooks/useUserMedia.d.ts

@@ -0,0 +1,104 @@
+export interface UseUserMediaProps {
+    /**
+     * - **EN:** The media constraints for the audio and video stream.
+     * - **CN:** 媒体流的媒体约束。
+     */
+    media: Pick<MediaStreamConstraints, 'audio' | 'video'>;
+    /**
+     * - **EN:** Whether to enable PCM output, only effective when recording audio. Please use
+     *   `onPcmStreamChunk` callback to get PCM data. Default is `false`.
+     * - **CN:** 是否启用 PCM 输出，仅在录制音频时有效。请使用 `onPcmStreamChunk` 回调获取 PCM 数据。默认`false`
+     */
+    pcmAudioOptions?: {
+        /**
+         * - **EN:** The audio context options for the PCM output.
+         * - **CN:** PCM 输出的音频上下文选项。
+         */
+        audioContext?: AudioContextOptions;
+        /**
+         * - **EN:** The worklet options for the PCM output.
+         * - **CN:** PCM 输出的工作线程选项。
+         */
+        workletOptions?: AudioWorkletNodeOptions;
+    };
+    /**
+     * - **EN:** Callback function that is triggered when the recording starts, providing the media
+     *   stream.
+     * - **CN:** 开始录制时触发的回调函数，提供媒体流。
+     *
+     * @param {MediaStream} stream - The media stream.
+     */
+    onStartRecording?: (stream: MediaStream) => void;
+    /**
+     * - **EN:** Callback function that is triggered when the recording stops.
+     * - **CN:** 停止录制时触发的回调函数。
+     */
+    onStopRecording?: () => void;
+    /**
+     * - **EN:** Callback function that is triggered when a new chunk of media data is available.
+     * - **CN:** 当录制媒体流时，每个时间分片会触发一次 `onStreamChunk` 回调，提供媒体数据块。
+     *
+     * > 注意音频流编码格式为：audio/webm;codecs=opus。如果希望获取 PCM 数据，请使用 `onPcmData` 回调。
+     *
+     * @param {Blob} chunk - The media data chunk (MIME: audio/webm;codecs=opus) | 媒体数据块 (MIME:
+     *   audio/webm;codecs=opus)
+     */
+    onStreamChunk?: (chunk: Blob) => void;
+    /**
+     * - **EN:** Callback for raw PCM float data (per render quantum)
+     * - **CN:** 获取原始 PCM 浮点数据的回调（每个渲染量子）
+     *
+     * @param data Monophonic or polyphonic spliced data | 单声道或多声道拼接数据
+     * @param sampleRate Sample rate | 采样率
+     */
+    onPcmStreamChunk?: (channels: Float32Array[], sampleRate: number) => void;
+    /**
+     * - **EN:** Whether to disable this hook.
+     * - **CN:** 是否禁用此工具
+     */
+    disabled?: boolean;
+    /**
+     * - **EN:** The slicing time period (milliseconds) for each fragment of the audio and video stream,
+     *   each time slice will trigger the `onStreamChunk` callback. Default is `500`.
+     * - **CN:** 媒体流每个分片的切片时间段（毫秒），每个时间分片会触发一次 `onStreamChunk` 回调，默认值为 `500`。
+     */
+    streamSliceMs?: number;
+    /**
+     * - **EN:** The silence detection threshold (0-1) for the audio stream, below which the audio is
+     *   considered silent. Default is `0`.
+     * - **CN:** 音频流的静音检测阈值（0-1），低于该值音频被视为静音。默认值为 `0`。
+     */
+    soundDetectionThreshold?: number;
+    /**
+     * - **EN:** The timeout duration (milliseconds) for detecting sound input. If no sound is detected
+     *   within this period, the user will be prompted to re-select the audio device. Default is
+     *   `3000`.
+     * - **CN:** 检测是否有声音输入的超时时间（毫秒），如果在该时间段内没有检测到声音，则会提示用户重新选择音频设备。默认值为 `3000`。
+     */
+    soundDetectionTimeout?: number;
+}
+declare const useUserMedia: (props: UseUserMediaProps) => UseUserMediaResult;
+export interface UseUserMediaResult {
+    /**
+     * - **EN** Whether the media stream is currently being recorded
+     * - **CN** 是否正在录制媒体流
+     */
+    isRecording: boolean;
+    /**
+     * - **EN** Start recording the media stream
+     * - **CN** 开始录制媒体流
+     */
+    startRecording: () => Promise<MediaRecorder>;
+    /**
+     * - **EN** Stop recording the media stream
+     * - **CN** 停止录制媒体流
+     */
+    stopRecording: () => void;
+    /**
+     * - **EN** Get the media stream being recorded, returns the stream if recording, otherwise returns
+     *   `undefined`
+     * - **CN** 获取正在录制的媒体流，如果正在录制则返回该流，否则返回 `undefined`
+     */
+    mediaStream?: MediaStream;
+}
+export default useUserMedia;