mirror of
https://github.com/vrm-c/UniVRM.git
synced 2026-04-18 13:07:48 -05:00
164 lines
4.1 KiB
Markdown
164 lines
4.1 KiB
Markdown
# `v0.44` RuntimeImport
|
||
|
||
## `Version 0.44～` LoadAsyncの例
|
||
|
||
```csharp
|
||
var bytes = File.ReadAllBytes(path);
|
||
// なんらかの方法でByte列を得る
|
||
|
||
var context = new VRMImporterContext();
|
||
|
||
context.ParseGlb(bytes);
|
||
|
||
// metaが必要な場合
|
||
bool createThumbnail=true;
|
||
var meta = context.ReadMeta(createThumbnail);
|
||
var thumbnail = meta.Thumbnail;
|
||
|
||
// modelを構築
|
||
context.LoadAsync(_ =>
|
||
{
|
||
context.ShowMeshes();
|
||
var go = context.Root;
|
||
// load完了
|
||
},
|
||
Debug.LogError);
|
||
```
|
||
|
||
## LoadAsyncTaskを使う例
|
||
|
||
```csharp
|
||
#if (NET_4_6 && UNITY_2017_1_OR_NEWER)
|
||
async static Task<GameObject> LoadAsync(Byte[] bytes)
|
||
{
|
||
var context = new VRMImporterContext();
|
||
|
||
// GLB形式でJSONを取得しParseします
|
||
context.ParseGlb(bytes);
|
||
|
||
try
|
||
{
|
||
// ParseしたJSONをシーンオブジェクトに変換していく
|
||
await context.LoadAsyncTask();
|
||
|
||
// バウンディングボックスとカメラの位置関係で見切れるのを防止する
|
||
// SkinnedMeshRenderer.updateWhenOffscreen = true
|
||
context.EnableUpdateWhenOffscreen();
|
||
|
||
// T-Poseのモデルを表示したくない場合、ShowMeshesする前に準備する
|
||
// ロード後に表示する
|
||
context.ShowMeshes();
|
||
|
||
return context.Root;
|
||
}
|
||
catch(Exception ex)
|
||
{
|
||
Debug.LogError(ex);
|
||
// 関連するリソースを破棄する
|
||
context.Destroy(true);
|
||
throw;
|
||
}
|
||
}
|
||
#endif
|
||
```
|
||
|
||
## 関連する記事など
|
||
|
||
こちらの記事がわかりやすいです。
|
||
|
||
* [UniVRMを使ってVRMモデルをランタイムロードする方法](https://qiita.com/sh_akira/items/8155e4b69107c2a7ede6)
|
||
|
||
|
||
最新バージョンは[こちら]({{< relref "runtime_import.md" >}})をご覧ください。
|
||
|
||
Unityで実行時にモデルをインポートする方法です。
|
||
|
||
## ファイルパスからVRMを開く
|
||
|
||
```csharp
|
||
var path="sample.vrm";
|
||
var go=VRM.VRMImporter.LoadFromPath(path);
|
||
Debug.LogFormat("loaded {0}", go.name);
|
||
```
|
||
|
||
## ファイルパスから非同期にVRMを開く
|
||
|
||
```csharp
|
||
var path="sample.vrm";
|
||
VRMImporter.LoadVrmAsync(path, go => {
|
||
Debug.LogFormat("loaded {0}", go.name);
|
||
});
|
||
```
|
||
|
||
## バイト列からVRM開く
|
||
|
||
```csharp
|
||
var path="sample.vrm";
|
||
var bytes = File.ReadAllBytes(path);
|
||
var go=VRMImporter.LoadFromBytes(bytes);
|
||
```
|
||
|
||
## バイト列から非同期にVRMを開く
|
||
|
||
```csharp
|
||
VRMImporter.LoadVrmAsync(bytes, go => {
|
||
Debug.LogFormat("loaded {0}", go.name);
|
||
});
|
||
```
|
||
|
||
## VRMから情報を取り出す
|
||
|
||
```csharp
|
||
#if UNITY_STANDALONE_WIN
|
||
var path = FileDialogForWindows.FileDialog("open VRM", ".vrm");
|
||
#else
|
||
var path = Application.dataPath + "/default.vrm";
|
||
#endif
|
||
if (string.IsNullOrEmpty(path))
|
||
{
|
||
return;
|
||
}
|
||
|
||
// Byte列を得る
|
||
var bytes = File.ReadAllBytes(path);
|
||
|
||
var context = new VRMImporterContext();
|
||
|
||
// GLB形式をParseしてチャンクからJSONを取得しParseします
|
||
context.ParseGlb(bytes);
|
||
|
||
// metaを取得
|
||
var meta = context.ReadMeta();
|
||
Debug.LogFormat("meta: title:{0}", meta.Title);
|
||
|
||
// もしくはこちらでパースされたGLTF全体にアクセスできます
|
||
var vrm = context.GLTF;
|
||
|
||
// ParseしたJSONをもとにシーンを構築します
|
||
if (m_loadAsync)
|
||
{
|
||
// 非同期に実行する
|
||
var now = Time.time;
|
||
VRMImporter.LoadVrmAsync(context, go=> {
|
||
var delta = Time.time - now;
|
||
Debug.LogFormat("LoadVrmAsync {0:0.0} seconds", delta);
|
||
OnLoaded(go);
|
||
});
|
||
}
|
||
else
|
||
{
|
||
// 同期的に実行する
|
||
VRMImporter.LoadFromBytes(context);
|
||
OnLoaded(context.Root);
|
||
}
|
||
```
|
||
|
||
## Thumbnailを取得する(v0.37から)
|
||
|
||
ReadMetaに引数を渡すことでThumbnailテクスチャを作成できます。
|
||
|
||
```csharp
|
||
var meta = context.ReadMeta(true); // Thumbnailテクスチャを作成する
|
||
Texture2D thumbnail=meta.Thumbnail;
|
||
```
|