@vatom/3d-face
v4.0.8
Published
This vAtom face can plug into the SDKs to render 3D content in either binary glTF or V3D format.
Readme
3D Face
This is a face for the Android, iOS and Web BLOCKv SDKs, which allows rendering and interacting with 3D vatoms.
Usage in the Android SDK
First add it to your gradle dependencies:
// In root build.gradle
allprojects {
...
repositories {
...
maven { url "https://jitpack.io" }
}
}// In app/build.gradle
dependencies {
implementation 'com.github.VatomInc:3d-face:+'
}Then register it on app startup:
// Kotlin
import io.blockv.face3d.Face3D
blockv.faceManager.registerFace(Face3D.factory)// Java
import io.blockv.face3d.Face3D;
blockv.getFaceManager().registerFace(Face3D.Companion.getFactory());Usage in the iOS SDK
First add it to your podfile:
pod 'VatomFace3D'Then register it on app startup:
import BLOCKv
import VatomFace3D
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
...
FaceViewRoster.shared.register(Face3D.self)
}Usage in the Web SDK
To use in the Web SDK, simply import and register when your app starts up:
import { VatomView } from '@vatom/sdk/face'
import Face3D from '@vatom/3d-face'
VatomView.registerFace(Face3D)Specification
- Display URL:
native://generic-3d
Building
To build, run npm run build. This results in running these scripts in this order:
build-libwill compile the face code intodist/Face3D.min.jscopy-webappwill copy all the files indist/and put them intowebapp/. This is the folder containing the wrapper web app the native apps use. The iOS library uses these files directly.copy-androidcopies all files inwebapp/into the Android project'sassets/folder. This is because I couldn't get the Android gradle build process to read these files directly.
