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

宽高比 3:4

宽高比 9:16

全屏

原作者提示:把布局的高度设为 70%,可以得到更标准的相机尺寸;作者还计划提供单独的扩展,自动实现 1:1、3:4、9:16 的宽高比。
权限要求
初始化时必须授予以下权限:


方法
- 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 不能):

- 使用伴侣(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):设备物理方向在竖屏 / 横屏之间切换时触发:

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

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(),供配合作者的另一款滤镜拓展使用(尚未发布,作者表示可能收费):

作者在帖内表示:叠加拍摄(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日
扫码添加客服咨询