Enhance README.md

This commit is contained in:
Masataka SUMI
2022-11-06 17:21:28 +09:00
parent d9e4a744a6
commit 0527898307

View File

@@ -1,18 +1,86 @@
# UniVRM
UniVRM is `unity package` for Import and Export [VRM Format](https://vrm.dev/vrm_about/)
![GitHub latest release](https://img.shields.io/github/v/release/vrm-c/UniVRM?color=green)
![GitHub license](https://img.shields.io/github/license/vrm-c/UniVRM)
## Download
The standard implementation of 3D Avatar file format [VRM](https://vrm-consortium.org/en/) for [Unity](https://unity.com/).
* https://github.com/vrm-c/UniVRM/releases
UniVRM supports import and export the VRM file at both runtime and editor.
VRM is an extension of [glTF 2.0](https://www.khronos.org/gltf/), so this library also support the glTF file.
## Manual
## Features
* https://vrm.dev/docs/univrm/
UniVRM supports the [VRM 1.0 specification](https://github.com/vrm-c/vrm-specification) and the [glTF 2.0 specification](https://registry.khronos.org/glTF/).
## API Document
UniVRM can import/export following supported file types at both runtime and editor.
* https://vrm-c.github.io/UniVRM/
### Supported file types
- VRM 1.0 (.vrm)
- VRM 0.x (.vrm)
- glTF 2.0 (.glb | .gltf | .zip)
### Import features
- You can import supported file types at both runtime and editor.
- Support for async/await importing at runtime.
- Support for Migration VRM 0.x files into VRM 1.0 files.
- Support for ScriptedImporter for VRM 1.0 and glTF 2.0.
- You can import glTF's PBR materials into Unity Built-in RP's Standard materials.
### Export features
- You can export supported file types at both runtime and editor.
- You can export Unity Built-in RP's Standard materials into glTF's PBR materials.
## Requirements
The latest UniVRM supports Unity 2020.3 LTS or later.
## Installation
![GitHub latest release](https://img.shields.io/github/v/release/vrm-c/UniVRM?color=green)
You can install UniVRM using the UnityPackager or UPM Package.
### UnityPackage
From the [latest release](https://github.com/vrm-c/UniVRM/releases/latest), you can download the `.unitypackage` files.
- For handling VRM 1.0
- You can download **VRM-0.XXX.X-YYYY.unitypackage**.
- You can also download sample projects as **VRM_Samples-0.XXX.X-YYYY.unitypackage**.
- For handling VRM 0.x
- You can download **UniVRM-0.XXX.X-YYYY.unitypackage**.
- You can also download sample projects as **UniVRM_Samples-0.XXX.X-YYYY.unitypackage**.
- For handling glTF 2.0
- You can download **VRM-0.XXX.X-YYYY.unitypackage**.
### UPM Package
From the [latest release](https://github.com/vrm-c/UniVRM/releases/latest), you can find UPM package urls.
- For import/export VRM 1.0
- You have to install all of the following UPM packages.
- `com.vrmc.vrmshaders`
- `com.vrmc.gltf`
- `com.vrmc.vrm`
- For import/export VRM 0.x
- You have to install all of the following UPM packages.
- `com.vrmc.vrmshaders`
- `com.vrmc.gltf`
- `com.vrmc.univrm`
- For import/export glTF 2.0
- You have to install all of the following UPM packages.
- `com.vrmc.vrmshaders`
- `com.vrmc.gltf`
You can install these UPM packages via `Package Manager` -> `+` -> `Add package from git URL...` in UnityEditor.
## Documentation
- https://vrm.dev/en/vrm/index.html
### For developers
- https://vrm-c.github.io/UniVRM/en/
## License