更新记录

1.0.0（2026-05-06）

版本初始化发布。

平台兼容性

uni-app(4.74)

uni-app x(4.74)

概述

zf-cameraUTS封装了Android、Harmony和iOS自定义相机预览的功能。

模块调用

<xf-camera style="height:750rpx; background-color: red;" @ready="ready" @error="onError" @stop="stop" :flash="flash" :position="device">
</xf-camera>

参数说明：

position：

• 类型：字符串型
• 描述：（可选项）前置或者后置相机。(front前置 |back 后置)

flash：

• 类型：字符串型
• 描述：（可选项）是否开启闪光灯。( auto, on, off, torch)

插件接口

takePhoto

拍照

uni-app项目中（nvue）调用示例：

import { takePhoto } from "@/uni_modules/zf-cameraUTS"

takePhoto({
  success: (res) => {
    console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { takePhoto } from "@/uni_modules/zf-cameraUTS";
import { TakePhotoOption, TakePhotoSuccessCallbackResult } from "@/uni_modules/zf-cameraUTS/utssdk/interface.uts";

let options = {
  success: (res : TakePhotoSuccessCallbackResult) => {
    console.log(res)
  }
} as TakePhotoOption;
takePhoto(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

startRecord

开始录像

uni-app项目中（nvue）调用示例：

import { startRecord } from "@/uni_modules/zf-cameraUTS"

startRecord({
  success: (res) => {
    console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { startRecord } from "@/uni_modules/zf-cameraUTS";
import { CameraContextStartRecordOption, GeneralCallbackResult } from "@/uni_modules/zf-cameraUTS/utssdk/interface.uts";

let options = {
  success: (res : GeneralCallbackResult) => {
    console.log(res)
  }
} as CameraContextStartRecordOption;
startRecord(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

stopRecord

停止录像

uni-app项目中（nvue）调用示例：

import { stopRecord } from "@/uni_modules/zf-cameraUTS"

stopRecord({
  success: (res) => {
    console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { stopRecord } from "@/uni_modules/zf-cameraUTS";
import { CameraContextStopRecordOption, StopRecordSuccessCallbackResult } from "@/uni_modules/zf-cameraUTS/utssdk/interface.uts";

let options = {
  success: (res : StopRecordSuccessCallbackResult) => {
    console.log(res)
  }
} as CameraContextStopRecordOption;
stopRecord(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

switchCamera

切换相机

uni-app项目中（nvue）调用示例：

import { switchCamera } from "@/uni_modules/zf-cameraUTS"

switchCamera({
  position: 'back',
  success: (res) => {
    console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { switchCamera } from "@/uni_modules/zf-cameraUTS";
import { SwitchOption, GeneralCallbackResult } from "@/uni_modules/zf-cameraUTS/utssdk/interface.uts";

let options = {
   position: 'back',
  success: (res : GeneralCallbackResult) => {
    console.log(res)
  }
} as SwitchOption;
switchCamera(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本