搜索插件、代码仓与 APP 分类

插件详情v0.1.0

arcore_flutter_plugin

用于 ARCore SDK 的 Flutter 插件,Android 平台,用于构建新的增强现实体验

Android
近 30 天下载
653
喜欢数
337
Pub 分数
120

安装插件

flutter pub add arcore_flutter_plugin

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

arcore_flutter_plugin 是一个 Flutter 包,可让开发者在 Android 设备上使用 Google 的 ARCore SDK 构建增强现实(AR)体验。它在 Flutter 和 ARCore 之间提供了一个桥梁,使开发者能够在 Flutter 应用中集成 3D 内容、运动追踪和环境理解功能。该插件专为 Android 设计,支持平面检测、光照估算和对象锚定等功能。开发者可以利用此工具创建用于游戏、教育、零售等领域的沉浸式 AR 应用。该插件是开源的,并由社区积极维护。

适合场景

  • 构建AR游戏
  • 创建交互式产品可视化
  • 开发教育类AR工具
  • 提升零售购物体验
  • 实施AR导航辅助

主要特点

  • ARCore SDK 集成
  • 平面和表面检测
  • 运动追踪
  • 光线估算
  • 3D对象锚定

适合对象

  • 仅限 Android 的 AR 开发者
  • Flutter 开发者探索 AR
  • 教育类应用程序创作者
  • 零售和电子商务平台

使用建议

  • 仅限 Android 平台
  • 需要兼容的硬件
  • 可能需要额外设置以获得最佳性能
  • 取决于设备上的 ARCore 可用性

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

I'm working to a new sceneview_flutter plugin to implement all features available in sceneview. SceneView is a Sceneform Maintained replacement in Kotlin.

arcore_flutter_plugin

Awesome Flutter

Thanks to Oleksandr Leuschenko for inspiration and his precious code: arkit_flutter_plugin

Usage

I wrote 2 articles for setup you project and start with ARCore Flutter Plugin:

ARCore Flutter Plugin: configurations.

ARCore Flutter Plugin: add object on the plane.

Configure your app

To use this plugin, add arcore_flutter_plugin as a dependency in your pubspec.yaml file.

  1. Follow official guide to enable ArCore

  2. Add the Sceneform library to your app's build.gradle file:

android {
    // Sceneform libraries use language constructs from Java 8.
    // Add these compile options if targeting minSdkVersion < 26.
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

dependencies {
    …

    // Provides ArFragment, and other UX resources.
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.8.0'

    // Alternatively, use ArSceneView without the UX dependency.
    implementation 'com.google.ar.sceneform:core:1.8.0'
}
  1. Import the Sceneform plugin into your project (OPTIONAL)

Example

The simplest code example:

import 'package:arcore_flutter_plugin/arcore_flutter_plugin.dart';
import 'package:flutter/material.dart';
import 'package:vector_math/vector_math_64.dart' as vector;

class HelloWorld extends StatefulWidget {
  @override
  _HelloWorldState createState() => _HelloWorldState();
}

class _HelloWorldState extends State<HelloWorld> {
  ArCoreController arCoreController;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Hello World'),
        ),
        body: ArCoreView(
          onArCoreViewCreated: _onArCoreViewCreated,
        ),
      ),
    );
  }

  void _onArCoreViewCreated(ArCoreController controller) {
    arCoreController = controller;

    _addSphere(arCoreController);
    _addCylindre(arCoreController);
    _addCube(arCoreController);
  }

  void _addSphere(ArCoreController controller) {
    final material = ArCoreMaterial(
        color: Color.fromARGB(120, 66, 134, 244));
    final sphere = ArCoreSphere(
      materials: [material],
      radius: 0.1,
    );
    final node = ArCoreNode(
      shape: sphere,
      position: vector.Vector3(0, 0, -1.5),
    );
    controller.addArCoreNode(node);
  }

  void _addCylindre(ArCoreController controller) {
    final material = ArCoreMaterial(
      color: Colors.red,
      reflectance: 1.0,
    );
    final cylindre = ArCoreCylinder(
      materials: [material],
      radius: 0.5,
      height: 0.3,
    );
    final node = ArCoreNode(
      shape: cylindre,
      position: vector.Vector3(0.0, -0.5, -2.0),
    );
    controller.addArCoreNode(node);
  }

  void _addCube(ArCoreController controller) {
    final material = ArCoreMaterial(
      color: Color.fromARGB(120, 66, 134, 244),
      metallic: 1.0,
    );
    final cube = ArCoreCube(
      materials: [material],
      size: vector.Vector3(0.5, 0.5, 0.5),
    );
    final node = ArCoreNode(
      shape: cube,
      position: vector.Vector3(-0.5, 0.5, -3.5),
    );
    controller.addArCoreNode(node);
  }

  @override
  void dispose() {
    arCoreController.dispose();
    super.dispose();
  }
}

See the example directory for a complete sample app.

3D Objects Credits

Anonymous


Documentation

Classes provided by the plugin

There are a total of 13 classes provided by this plugin until May 2020.

  • ArCoreView
  • ArCoreController
  • ArCoreFaceView
  • ArCoreFaceContrller
  • ArCoreSphere
  • ArCoreCylinder
  • ArCoreCube
  • ArCoreNode
  • ArCoeMaterial
  • ArCoreHitTestResult
  • ArCoreRotatingNode
  • ArCorePlane
  • ArCoreReferenceNode

ArCoreView

This class returns the view type. There are two types of views in it.

AUGMENTEDFACE STANDARDVIEW

There are 4 properties in it:

  • onArCoreViewCreated
  • enableTapRecoginzer
  • enableUpdateListener
  • type

onArCoreViewCreated

This property takes a ArCoreController.


enableTapRecoginzer

Initially, set to false. It is used as an argument by the MethodChannel.


enableUpdateListener

Initially, set to false. It is used as an argument by the MethodChannel.


type

It is a view type, it is either AUGMENTEDFACE, STANDARDVIEW*. It is set to STANDARDVIEW by default.


ArCoreController

This controller used to add a ArNode using addArCoreNode function, add a ArCoreNode with ancher using a addArCoreNodeWithAncher function and also remove node using removeNode function.


ArCoreFaceView

It is a stateful widget that returns a ArCoreAndroidView. It has two properties enableAugmentedFaces, onArCoreViewCreated.

Initially, enableAugmentedFaces is set to false. onArCoreViewCreated takes a function with ArCoreController argument.


ArCoreFaceController

It used dispose and loadMesh method to control the FaceView.


ArCoreSphere

It is ArCoreShape, takes a radius & ArCoreMaterial.


ArCoreCylender

It is ArCoreShape, takes a radius, height, & ArCoreMaterial.


ArCoreCube

It is ArCoreShape, takes a size i.e. Vector3 & ArCoreMaterial.


ArCoreNode

This widget is used to provide the position, shape, scale, rotation, name.


ArCoreMaterial

It is used to describe the outlook of the virtual object created by the user.

It has color,textureBytes, metallic, roughness, reflection.


ArCoreRotatingNode

It is an ArCoreNode with a degreesPerSecond property which is a double value.


ArCorePlane

It takes the x, y coordinate of the plane, ArCorePose & ArCorePlaneType.

There are three types of plane:

  • HORIZONTAL_UPWARD_FACING
  • HORIZONTAL_DOWNWARD_FACING
  • VERTICAL

ArCoreReferenceNode

It is ArCoreNode, it has all the properties that the ArCoreNode has also it has objectUrl and object3DFileName.


objectUrl

URL of glft object for remote rendering.


object3DFileName

Filename of sfb object in assets folder.

所属分类

依赖

依赖清单 3 项

源码仓库

使用此插件的项目