Sceneform Android SDK 使用教程

Sceneform Android SDK 使用教程

sceneform-android-sdk Sceneform SDK for Android 项目地址: https://gitcode.com/gh_mirrors/sc/sceneform-android-sdk

1. 项目目录结构及介绍

Sceneform Android SDK 的目录结构如下：

sceneform-android-sdk
├── CONTRIBUTING.md
├── LICENSE
├── MIGRATING-1.15.0-1.16.0.md
├── README.md
├── sceneformsrc
│   ├── ...
│   └── ...
├── sceneformux
│   ├── ...
│   └── ...
└── samples
    └── gltf
        ├── ...
        └── ...

目录结构介绍

• CONTRIBUTING.md: 贡献指南，指导开发者如何为项目贡献代码。
• LICENSE: 项目许可证，采用 Apache-2.0 许可证。
• MIGRATING-1.15.0-1.16.0.md: 迁移指南，帮助开发者从旧版本迁移到新版本。
• README.md: 项目介绍文件，包含项目的基本信息和使用说明。
• sceneformsrc: Sceneform 的核心源代码目录，包含 SDK 的主要实现。
• sceneformux: Sceneform 的用户体验相关代码，包含 UI 组件和交互逻辑。
• samples: 示例代码目录，包含使用 Sceneform SDK 的示例项目。

2. 项目启动文件介绍

Sceneform SDK 的启动文件主要位于 sceneformsrc 和 sceneformux 目录中。以下是主要的启动文件：

sceneformsrc/...

• Sceneform.java: Sceneform 的主类，负责初始化和配置 Sceneform SDK。
• Renderer.java: 渲染器类，负责处理 3D 模型的渲染逻辑。
• Material.java: 材质类，定义 3D 模型的材质属性。

sceneformux/...

• SceneformActivity.java: 用户界面活动类，负责管理 Sceneform 的用户界面和交互逻辑。
• SceneformFragment.java: 用户界面片段类，用于在应用中嵌入 Sceneform 的 UI 组件。

3. 项目配置文件介绍

Sceneform SDK 的配置文件主要位于项目的根目录和 sceneformsrc 目录中。以下是主要的配置文件：

根目录

• build.gradle: 项目的全局 Gradle 配置文件，定义项目的基本配置和依赖项。
• settings.gradle: 项目的设置文件，定义项目的模块和依赖关系。

sceneformsrc/...

• build.gradle: Sceneform 模块的 Gradle 配置文件，定义模块的依赖项和构建配置。
• AndroidManifest.xml: Sceneform 模块的 Android 清单文件，定义模块的权限和组件。

配置文件示例

build.gradle (根目录)

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.1.0'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

settings.gradle

include ':app'
include ':sceneform'
project(':sceneform').projectDir = new File('sceneformsrc/sceneform')
include ':sceneformux'
project(':sceneformux').projectDir = new File('sceneformux/ux')

build.gradle (sceneformsrc)

apply plugin: 'com.android.library'

android {
    compileSdkVersion 30
    defaultConfig {
        minSdkVersion 24
        targetSdkVersion 30
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0'
}

AndroidManifest.xml (sceneformsrc)

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.ar.sceneform">

    <application>
        <activity android:name=".SceneformActivity" />
        <activity android:name=".SceneformFragment" />
    </application>

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

通过以上配置文件，开发者可以轻松地集成和配置 Sceneform SDK，实现增强现实应用的开发。

sceneform-android-sdk Sceneform SDK for Android 项目地址: https://gitcode.com/gh_mirrors/sc/sceneform-android-sdk