Flutter增强现实滤镜插件argear_flutter_plugin的使用

Flutter增强现实滤镜插件argear_flutter_plugin的使用

ARGear Flutter 插件

ARGear SDK Flutter 插件。此插件支持 Android 和 iOS。ARGear SDK 支持的所有功能也都是此插件支持的功能。

注意事项

• Flutter 版本 <= 2.10.5 使用此插件版本 0.0.2
• Flutter 版本 >= 3.0.0 使用此插件版本 0.0.3

开始使用

Android

在应用级别打开 build.gradle 文件，并添加 minSdkVersion 23：

defaultConfig {
    minSdkVersion 23
}

打开 AndroidManifest.xml 文件并添加所需的设备权限和功能：

<manifest xmlns:tools="http://schemas.android.com/tools">
    ...
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

    <uses-feature
            android:glEsVersion="0x00030001"
            android:required="true" />

    <uses-feature
            android:name="android.hardware.camera"
            android:required="true"/>

    <application
            tools:replace="android:label">
    ...
</manifest>

iOS

打开 info.plist 文件并添加以下内容：

• Privacy - Microphone Usage Description，并在值列中添加备注（NSMicrophoneUsageDescription）
• Privacy - Camera Usage Description，并在值列中添加备注（NSCameraUsageDescription）
• Privacy - Photo Library Usage Description，并在值列中添加备注（NSPhotoLibraryUsageDescription, NSPhotoLibraryAddUsageDescription）

使用示例

以下是使用 ARGear Flutter 插件的基本示例：

import 'package:flutter/material.dart';
import 'package:argear_flutter_plugin/argear_flutter_plugin.dart'; // 引入插件

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: SafeArea(
          child: Stack(
            children: [
              ARGearView(
                onArGearViewCreated: _onArGearViewCreated, // 创建回调
                apiUrl: "API_URL", // 从ARGear主页获取
                apiKey: "API_KEY", // 从ARGear主页获取
                secretKey: "SECRET_KEY", // 从ARGear主页获取
                authKey: "AUTH_KEY", // 从ARGear主页获取
                onCallback: (method, arguments) {
                  debugPrint(method.toString() + ' / ' + arguments.toString()); // 回调函数
                },
                onPre: (method, arguments) {
                  debugPrint(method.toString() + ' / ' + arguments.toString()); // 预处理回调
                },
                onComplete: (method, arguments) {
                  debugPrint(method.toString() + ' / ' + arguments.toString()); // 完成回调
                },
              ),
            ],
          ),
        ),
      ),
    );
  }

  void _onArGearViewCreated(ARGearController controller) {
    // 当视图创建时的回调
  }
}

完整示例代码

以下是完整的示例代码，你可以将其复制到你的 Flutter 项目中进行测试：

import 'package:flutter/material.dart';
import 'package:argear_flutter_plugin/argear_flutter_plugin.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: SafeArea(
          child: Stack(
            children: [
              ARGearView(
                onArGearViewCreated: _onArGearViewCreated,
                apiUrl: "API_URL",
                apiKey: "API_KEY",
                secretKey: "SECRET_KEY",
                authKey: "AUTH_KEY",
                onCallback: (method, arguments) {
                  debugPrint(method.toString() + ' / ' + arguments.toString());
                },
                onPre: (method, arguments) {
                  debugPrint(method.toString() + ' / ' + arguments.toString());
                },
                onComplete: (method, arguments) {
                  debugPrint(method.toString() + ' / ' + arguments.toString());
                },
              ),
            ],
          ),
        ),
      ),
    );
  }

  void _onArGearViewCreated(ARGearController controller) {
    // 当视图创建时的回调
  }
}