Pro Camera 扩展

Pro Camera 扩展

Pro Camera 是基于最新 Android Camera API 设计的专业相机扩展，提供更丰富的相机功能和控制选项。

扩展需要 Android 5.0 Lollipop 及以上版本才能正常工作。

下载链接

com.kumaraswamy.camerax.aix

功能概述

扩展特性

使用最新的 Camera API
相机滤镜功能
降噪模式
预览和输出的增强模式
相机对焦锁定和解锁
距离手动对焦（目前在支持该功能的设备上可用）
普通相机的其他次要功能

截图

主要界面

相机预览1

相机预览2

手动对焦

函数

Initialize 初始化(宽度,高度)

初始化相机并设置预览尺寸。

宽度：数字类型，相机预览宽度
高度：数字类型，相机预览高度

初始化方法

IsSupported 是否支持() {:.boolean}: 检查设备是否支持当前相机功能。

支持检查方法

Lock 锁定对焦(): 锁定相机对焦。

锁定方法

Unlock 解锁对焦(): 解锁相机对焦。

解锁方法

Refresh 刷新(): 刷新相机状态。

刷新方法

事件

Unlocked 解锁后(): 相机对焦解锁后触发。

解锁事件

Initialized 初始化后(): 相机初始化完成后触发。

初始化事件

Refreshed 刷新后(): 相机刷新完成后触发。

刷新事件

Saved 保存后(): 照片保存完成后触发。

保存事件

ZoomChanged 缩放改变后(缩放级别)

相机缩放级别改变时触发。

缩放级别：数字类型，当前的缩放级别

缩放改变事件

属性

IsFlashAvailable 闪光灯可用 {:.boolean .read-only}: 返回设备是否支持闪光灯功能。
IsFocusAvailable 对焦可用 {:.boolean .read-only}: 返回设备是否支持自动对焦功能。
IsZoomAvailable 缩放可用 {:.boolean .read-only}: 返回设备是否支持缩放功能。
CurrentZoom 当前缩放 {:.number .read-only}: 返回当前的缩放级别。
MaxZoom 最大缩放 {:.number .read-only}: 返回支持的最大缩放级别。
FlashMode 闪光灯模式 {:.text}: 设置或获取闪光灯模式。
ColorEffect 颜色效果 {:.text}: 设置或获取相机的颜色滤镜效果。
FocusMode 对焦模式 {:.text}: 设置或获取相机的对焦模式。
SceneMode 场景模式 {:.text}: 设置或获取相机的场景模式。
WhiteBalance 白平衡 {:.text}: 设置或获取相机的白平衡模式。

使用示例

基本相机初始化

当 屏幕1.初始化
  调用 ProCamera1.Initialize 800 600
  如果 ProCamera1.是否支持 则
    设置 状态标签.文本 为 "相机支持正常"
  否则
    设置 状态标签.文本 为 "设备不支持相机功能"

手动对焦控制

当 对焦按钮.被点击
  调用 ProCamera1.锁定对焦
  设置 对焦状态文本.文本 为 "对焦已锁定"

当 解除对焦按钮.被点击
  调用 ProCamera1.解锁对焦
  设置 对焦状态文本.文本 为 "对焦已解锁"

缩放控制

当 ProCamera1.缩放改变后 缩放级别
  设置 缩放级别文本.文本 = "缩放级别: " & 缩放级别
  设置 缩放滑块.值 = 缩放级别

当 缩放滑块.位置改变
  如果 缩放滑块.值 <= ProCamera1.最大缩放 则
    设置 ProCamera1.当前缩放 = 缩放滑块.值

滤镜效果设置

当 滤镜选择器.选择完成
  如果 滤镜选择器.选中项 = "无" 则
    设置 ProCamera1.颜色效果 = "none"
  否则如果 滤镜选择器.选中项 = "黑白" 则
    设置 ProCamera1.颜色效果 = "mono"
  否则如果 滤镜选择器.选中项 = "深褐色" 则
    设置 ProCamera1.颜色效果 = "sepia"
  否则如果 滤镜选择器.选中项 = "负片" 则
    设置 ProCamera1.颜色效果 = "negative"

处理相机事件

当 ProCamera1.初始化后
  设置 状态文本.文本 = "相机初始化成功"
  如果 ProCamera1.闪光灯可用 则
    设置 闪光灯开关.启用 = true
  否则
    设置 闪光灯开关.启用 = false

当 ProCamera1.保存后
  设置 状态文本.文本 = "照片已保存"
  显示通知 "拍照成功！"

注意事项

系统要求：需要 Android 5.0 (Lollipop) 及以上版本
权限要求：需要相机和存储权限
设备兼容性：部分高级功能（如手动对焦）可能不支持所有设备
布局大小：相机布局大小超过 70% 可能看起来会拉伸
性能考虑：使用滤镜和处理功能可能会影响性能

技术限制

某些设备可能不支持所有 Camera2 API 功能
手动对焦功能仅支持具有该硬件功能的设备
不同厂商的设备实现可能存在差异
建议在实际目标设备上充分测试所有功能

版权信息

原作者：Kumaraswamy
原始网址：https://community.appinventor.mit.edu/t/pro-camera-the-pro-custom-camera/25353
发布日期：2021年1月27日

文档最后更新：2025年11月18日

Pro Camera 扩展：专业级自定义相机，提供滤镜、降噪、对焦等高级功能