JoeDevCamera 扩展:在布局中显示相机预览,程序控制拍照与录像

« 返回首页

JoeDevCamera 扩展

在布局组件中直接显示相机预览,用积木控制拍照和录制视频,无需打开系统相机应用。

下载

joejsanz.joedevcamera.aix(v1.3)

Camera.aia - 原作者示例项目

基本信息

  • 版本:v1.0(本站分发版本)
  • 发布时间:2025-09-04
  • JDK:11
  • 最低 API 级别:21
  • 构建方式:FAST-CLI v4.3.1
  • 原帖最新版:v1.3(2026-10-13,JDK 17 / 最低 API 14)

截图

宽高比 1:1

宽高比 1:1

宽高比 3:4

宽高比 3:4

宽高比 9:16

宽高比 9:16

全屏

全屏

原作者提示:把布局的高度设为 70%,可以得到更标准的相机尺寸;作者还计划提供单独的扩展,自动实现 1:1、3:4、9:16 的宽高比。

权限要求

初始化时必须授予以下权限:

权限积木 1

权限积木 2

方法

StartCamera启动相机(布局)
启动相机并在布局中显示预览。
  • 布局:要在其中显示相机预览的布局组件
StopCamera停止相机()
停止相机并释放资源。
SwitchCamera切换摄像头()
在前置和后置摄像头之间切换。
TakePicture拍照()
拍摄照片并自动保存。
SetZoomLevel设置缩放级别(级别)
调整缩放级别(1-10)。也可以不使用此方法,直接在屏幕上双指捏合进行缩放。
GetZoomLevel获取缩放级别()
获取当前缩放级别。
GetMaxZoomLevel获取最大缩放级别()
获取可用的最大缩放值。
FocusOnPoint对焦到指定点(x,y)
对屏幕上的指定点对焦(x、y 取 0 到 1 之间)。
CaptureAndGetPath拍照并获取路径()
拍摄一张照片并返回文件路径。
StartRecording开始录像()
开始录制视频。
StopRecording停止录像()
停止录制视频。
IsCameraActive相机是否已启动()
检查相机是否处于启动状态。
CameraResolution获取相机分辨率()
获取当前相机分辨率。
HasFlash是否有闪光灯()
检查设备是否有闪光灯。
AvailableCamerasCount获取可用摄像头数量()
获取可用摄像头的数量。
IsRecording是否正在录像()
检查当前是否正在录制视频。

事件

PictureTaken拍照完成时(照片路径)
照片拍摄成功后触发,返回保存的文件路径。
PictureError拍照出错时(错误信息)
拍照过程中发生错误时触发。
CameraReady相机就绪时()
相机准备就绪时触发。
CameraSwitched摄像头切换时(新摄像头ID)
摄像头切换完成时触发,返回切换后的摄像头 ID。
FocusedOnPoint点按对焦完成时(x,y)
对触摸点对焦完成时触发,返回对焦点的坐标。
RecordingStarted开始录像时(视频路径)
视频录制开始时触发,返回视频的保存路径。
RecordingStopped录像停止时(视频路径)
视频录制停止时触发,返回视频的保存路径。
RecordingError录像出错时(错误信息)
视频录制过程中发生错误时触发。
ZoomChanged缩放变化时(缩放级别,缩放系数)
缩放级别变化时触发,无论是通过手势还是通过积木设置。
ZoomEnded缩放结束时(缩放级别,缩放系数)
用户结束缩放操作时触发(松开屏幕或结束双指捏合)。

属性

CameraId摄像头 ID
要使用的摄像头 ID(0:后置,1:前置)。
FlashEnabled闪光灯开关
打开或关闭相机闪光灯。
AutoFocusEnabled自动对焦开关
打开或关闭自动对焦。
TouchToFocusEnabled触摸对焦开关
打开或关闭触摸对焦。开启后,触摸屏幕上的指定点即可对焦。
JpegQuality照片质量
照片的 JPEG 质量(0-100)。
SaveDirectory保存目录
照片的保存目录。目前仅支持保存到 Pictures(图片)目录。
CaptureSoundEnabled拍照提示音开关
拍照时打开或关闭快门声。
VideoBitrate视频码率
视频码率(比特每秒)。
VideoFrameRate视频帧率
视频的每秒帧率。
FocusFrameColor对焦框颜色
对焦框的颜色。
FocusFrameDisappearanceTime对焦框消失时间
对焦框的消失时间(毫秒)。
FocusFrameSize对焦框大小
对焦框的大小。

使用示例

以下示例假设已在设计视图中添加:一个用于显示相机预览的垂直布局、若干个按钮和一个标签。

启动相机并拍照

when Screen1.Initialize() {
  JoeDevCamera1.StartCamera(垂直布局1)
}

when 按钮_拍照.Click() {
  JoeDevCamera1.TakePicture()
}

when JoeDevCamera1.PictureTaken(imagePath) {
  标签_状态.Text = imagePath
}

录制视频(一个按钮切换开始/停止)

when 按钮_录像.Click() {
  if JoeDevCamera1.IsRecording() {
    JoeDevCamera1.StopRecording()
  } else {
    JoeDevCamera1.StartRecording()
  }
}

when JoeDevCamera1.RecordingStarted(videoPath) {
  标签_状态.Text = join("开始录像:", videoPath)
}

when JoeDevCamera1.RecordingStopped(videoPath) {
  标签_状态.Text = join("已保存:", videoPath)
}

变焦

when 按钮_放大.Click() {
  JoeDevCamera1.SetZoomLevel(JoeDevCamera1.GetZoomLevel() + 1)
}

when JoeDevCamera1.ZoomChanged(zoomLevel, zoomFactor) {
  标签_状态.Text = join("当前缩放:", zoomLevel)
}

切换前后摄像头

when 按钮_切换.Click() {
  JoeDevCamera1.SwitchCamera()
}

when JoeDevCamera1.CameraSwitched(newCameraId) {
  if newCameraId == 0 {
    标签_状态.Text = "后置摄像头"
  } else {
    标签_状态.Text = "前置摄像头"
  }
}

when JoeDevCamera1.FocusedOnPoint(x, y) {
  标签_状态.Text = "对焦完成"
}

版本更新

本页上方的方法 / 事件 / 属性清单以本站分发的 v1.0 为准;v1.1 起的新增内容如下,新版 aix 请到原帖下载。

v1.1(2026-03-07)

  • 新增方法 HasCameraPermission:检查相机权限是否已授予。
  • PictureTaken 事件新增参数,同时返回文件路径和 content URI(imagePath 在伴侣里可以直接用,URI 不能):

PictureTaken 事件(v1.1)

  • 使用伴侣(Companion)测试时,把 imagePath 放到图像组件里即可直接显示拍到的照片,不再需要加 file:// 前缀。

v1.2(2026-10-08)

  • 改用物理方向(deviceOrientation)代替屏幕旋转判断方向,照片保存时 EXIF 方向正确——部分设备(如三星)拍出横竖颠倒照片的老问题由此修复。此前社区的通用变通办法是:图像宽大于高时把 RotationAngle 设为 90。
    • 需把 Screen 的 Screen Orientation 属性设为 Portrait,相机才能在设备旋转后的两个方向上都正常工作。
  • 新增方法:GetOrientationMode(返回 Portrait / Landscape)、GetDeviceOrientation(返回角度 0 / 90 / 180 / 270)、GetActualPhotoResolution、GetActualVideoResolution、GetActualPreviewResolution、GetActualPhotoWidth、GetActualPhotoHeight、GetActualVideoWidth、GetActualVideoHeight、GetActualPhotoMegapixels(照片实际分辨率,单位兆像素)。
  • 新增属性:PhotoResolution、VideoResolution、PreviewResolution(均可选 Max / 1080p / 720p / 480p)和 OrientationTolerance(判定方向改变的角度容差,单位度)。
  • 新增事件 OrientationChanged(mode, angle):设备物理方向在竖屏 / 横屏之间切换时触发:

OrientationChanged 事件(v1.2)

  • 新增事件 CameraConfigured(photoResolution, videoResolution, previewResolution):相机配置完成时触发,返回实际使用的分辨率:

CameraConfigured 事件(v1.2)

v1.3(2026-10-13)

  • 新增属性 BrightnessLevel 亮度调节:-1.0(很暗)~ 1.0(很亮),0 为不调节,预览和拍出的照片同时生效。
  • 新增属性 SaturationLevel 饱和度调节:0.0(灰度)~ 2.0(很艳),1 为不调节。
  • 新增方法 ResetAdjustment:把亮度和饱和度恢复为默认值(0 和 1)。
  • 新增前置摄像头镜像模式:仅对照片生效,录像不适用。
  • 预留了滤镜接口积木:事件 FilterChanged(filterId),方法 SetFilterMatrix(matrixList)、ClearFilter()、GetActiveFilterId(),供配合作者的另一款滤镜拓展使用(尚未发布,作者表示可能收费):

v1.3 滤镜接口演示

作者在帖内表示:叠加拍摄(overlay capture)和滤镜等更多功能已在开发版中完成,是否免费开放尚在考虑。

版权信息

本文档内容依据原作者发布页面整理翻译,版权归原作者所有。

  • 原作者:Joe J. Sánchez(Joejsanz)
  • 原始网址:https://community.appinventor.mit.edu/t/camera-displays-the-camera-to-take-photos-and-record-videos-in-an-arrangement/154998
  • 发布日期:2025年9月4日
文档反馈