@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.
Downloads
25
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-lib
will compile the face code intodist/Face3D.min.js
copy-webapp
will 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-android
copies 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.