CameraView.Avalonia 1.0.18

CameraView.Avalonia

跨平台相机预览与拍照控件，基于 Avalonia UI 框架。

支持的平台

安装

dotnet add package CameraView.Avalonia

快速开始

1. XAML 引用

xmlns:cv="using:CameraView"

<cv:CameraViewControl x:Name="CameraControl" />

2. 启动相机

// 方式一：绑定 CameraEnabled（推荐，自动初始化）
CameraEnabled = true;

// 方式二：手动初始化并启动（需要 provider 引用时用此方式）
var provider = CameraProviderFactory.Create();
await CameraControl.InitializeCameraAsync(provider);
CameraEnabled = true;  // 自动触发 StartCameraAsync

💡 CameraEnabled = true 会自动判断是否需要初始化，无需手动调用 InitializeCameraAsync。

3. Windows 项目配置

桌面项目的 .csproj 中 TargetFramework 必须改为 Windows 专用 TFM：

- <TargetFramework>net10.0</TargetFramework>


+ <TargetFramework>net10.0-windows10.0.19041.0</TargetFramework>

⚠️ 多项目结构中，引用 CameraView 的项目（如 MyApp.Desktop.csproj）需要改， 不是共享库项目（MyApp.csproj 保持 net10.0）。

4. App.axaml — 加载控件模板

<Application.Styles>
    <FluentTheme />
    <StyleInclude Source="avares://CameraView/CameraViewControl.axaml" />
</Application.Styles>

5. Android 配置

⚠️ Android EXE 项目（如 MyApp.Android.csproj）必须直接引用 CameraView.Avalonia， 仅靠共享库（net10.0）间接引用不会触发 buildTransitive .targets 注入 Android JNI 文件。

<ItemGroup>
  <PackageReference Include="CameraView.Avalonia" />
  <ProjectReference Include="..\MyApp\MyApp.csproj" />
</ItemGroup>

// MainActivity.OnCreate — 必须在 base.OnCreate 之前注册
var context = this.BaseContext;
var provider = new CameraView.Platforms.Android.AndroidCameraProvider(context);
CameraView.CameraProviderFactory.RegisterProvider(provider);

base.OnCreate(savedInstanceState);

CameraView.CameraProviderFactory.SetAndroidActivity(this);

6. 权限

<uses-permission android:name="android.permission.CAMERA" />

// 启动前手动申请权限
var perms = CameraProviderFactory.CreatePermissions(provider);
if (!await perms.CheckPermissionAsync())
    if (!await perms.RequestPermissionAsync())
        return; // 无权限，ErrorOccurred 会触发说明

CameraEnabled = true;

无权限时相机启动会失败，通过 ErrorCommand（MVVM）或 CameraError 事件输出错误信息。

<cv:CameraViewControl ErrorCommand="{Binding OnCameraErrorCommand}" />

// ViewModel
[RelayCommand]
private void OnCameraError(string error)
{
    StatusText = $"相机错误: {error}";
}

或者订阅事件：

CameraControl.CameraError += (_, error) => Debug.WriteLine(error);

💡 调试模式性能提示： Debug 模式下 Mono 解释器/未优化 JIT 会导致 YUV→BGRA 帧转换性能显著降低，预览帧率可能降至 2-8fps。 使用 Release 配置（AOT 编译）可获得 25-30fps 流畅预览。

功能

• 相机预览（实时帧）
• 拍照（JPEG 输出）
• 前后摄像头切换
• 点击对焦
• 捏合缩放
• 手电筒（闪光灯）
• 闪光灯模式（自动/开/关）
• 曝光补偿
• 拍照分辨率选择（自动查询支持的分辨率）
• 设备朝向传感器（重力方向）
• 照片 EXIF 方向校正（iOS/Android 拍照时自动旋转像素）
• 调试模式（显示 FPS）

API 参考

依赖属性（可绑定）

方法

事件

平台支持