アマレコVR ダウンロードページ
■アマレコVR for Meta Quest
2023/7/15
アマレコVR Ver2.4.1 アルファ版 for Quest
記事
■アマレコVR for Pico4
2023/7/22
アマレコVR Ver2.4.1 アルファ版 for Pico4
記事
2022/12/26
アマレコVR Ver2.3.3 アルファ版 for Pico4
記事
■アマレコVRサーバー
2022/10/25
アマレコVRサーバー Ver2.21
記事
■アセットファイル
asset_sample_theater20230505.zip
動作確認用の映画館
asset_sample_cube20230505.zip
立方体１つだけの最小構成のアセットファイル
アセットファイルの作成が上手くできない場合に参考にしてください
asset_sample_pudding20230621.zip
物理処理のデモンストレーション
アセット機能 その６ 物理処理
■プレハブ
asset_sample_theater_prefab20230602.zip
映画館のプレハブファイル
アセット機能 その４ 映画館を作る
■その他
2023/7/15
sample_alpha_movie.zip
アルファ付きVR動画のサンプル
2023/8/12
rvm_alpha1_0_0.zip
アルファ付きVR動画作成ツール
記事
Meta Questで60fpsの動画を再生した場合について
今回はMeta Quest (Oculus Go、Oculus Quest)で60fpsの動画を再生した場合の話です。
もともと大抵のGoやQuest用メディアプレイヤー系アプリでは秒間50枚程度の映像しか表示することができません。
私が知る限り、初期から完全な形で動画の再生ができていた(リフレッシュレートを60Hzにして、60fpsの動画を再生して1秒間に60枚映像を表示することができる)のはOculus Go版のOculus galleryだけです。
Oculus Quest1発売当時 (2019年6月あたり)のQuest版Oculus galleryはおそらくリフレッシュレートが60Hzにできていないため、完全に滑らかな60fpsの再生とはなっていませんでした。
その後、おそらくQuest2が発売された2020年10月あたりにSkyBoxが60Hz、60fpsの再生に対応し、更に遅れた2021年6月にアマレコVR2が60Hz、60fpsに対応しました。
■ 50fps程度になってしまう原因
Oculus GoやQuestはスマホ用のOSであるAndroidがベースとなって開発されています。
また、動画を再生する際もAndroidの動画再生機能(現在はExoPlayerが主流)を使うのが一般的と思われます。
十分な性能のスマホを所有していないので未確認ではありますが、スマホであれば ExoPlayerとSurfaceViewを使って動画を再生することにより 簡単に良い結果が得られるものと思われます。
しかし、GoやQuestでは画面を表示する仕組みがAndroid用のスマホと異なり SurfaceViewが使えません。
そのため自動的に上手くやってもらえず、大抵の場合 動画再生機能の動作タイミングとディスプレイ装置のタイミングが合わず 表示されないフレームが発生してしまいます。
Oculus GoやQuestにおいて60Hz 60fpsで完全な再生をするには SurfaceViewに代わって アプリ側にタイミング調整の仕組みが必要となりますが、有名なassetのAVPro Ver1.11.5やOculus Integrationに含まれるプレイヤーアプリのサンプルではディスプレイ装置に合わせたタイミング調整が実装されていないため50fps程度の表示となってしまいます。
Android用のアプリ開発においてAVProはとても有力なassetと思われますので、Oculus GoやQuest用アプリでも多く使われていると思われます。
■ 60Hz 60fps以外にも
・60Hzで30fpsの動画を再生した際に きっちり2フレームずつ表示できるか
・72Hzで60fpsの動画を再生した際に 5フレーム表示した後 1フレーム休む と言った均等なフレーム割り当てができるか
・90Hzで60fpsの動画を150％で再生 早回しでもきれいに再生できるか
・60Hzで90fpsの動画を67％で再生 スロー再生でもきれいに再生できるか
・必ずタイミングはずれてくるので 10～20秒くらいに一度 意図的にフレームを飛ばしたり 重複させる処理が適切に行えているか
と言った評価ポイントがあります。
■ アマレコVRの最大fps
90Hz 90fpsまでは可能ですが、動画再生機能の上限が今のところ100fps弱なので120Hz 120fpsの再生はできません。
120Hz 60fpsでの再生は可能ですが 動いているものがぶれて見える（60Hzで 30fpsの動画を再生した場合と同じ印象）ため 60Hz 60fpsで再生した方が 見やすいです。
もともと大抵のGoやQuest用メディアプレイヤー系アプリでは秒間50枚程度の映像しか表示することができません。
私が知る限り、初期から完全な形で動画の再生ができていた(リフレッシュレートを60Hzにして、60fpsの動画を再生して1秒間に60枚映像を表示することができる)のはOculus Go版のOculus galleryだけです。
| アプリ | 機種 | 備考 |
| Oculus gallery | Go | 60Hz 60fps可 |
| Oculus gallery | Quest | 72Hz 60fps (恐らく60Hz非対応) |
| SkyBox | Quest | 50fps程度になってしまう 2020年10月あたりに60Hz 60fpsへ対応 |
| AmaRecVR | Quest | 50fps程度になってしまう 2021年6月に60Hz 60fpsへ対応 |
Oculus Quest1発売当時 (2019年6月あたり)のQuest版Oculus galleryはおそらくリフレッシュレートが60Hzにできていないため、完全に滑らかな60fpsの再生とはなっていませんでした。
その後、おそらくQuest2が発売された2020年10月あたりにSkyBoxが60Hz、60fpsの再生に対応し、更に遅れた2021年6月にアマレコVR2が60Hz、60fpsに対応しました。
■ 50fps程度になってしまう原因
Oculus GoやQuestはスマホ用のOSであるAndroidがベースとなって開発されています。
また、動画を再生する際もAndroidの動画再生機能(現在はExoPlayerが主流)を使うのが一般的と思われます。
十分な性能のスマホを所有していないので未確認ではありますが、スマホであれば ExoPlayerとSurfaceViewを使って動画を再生することにより 簡単に良い結果が得られるものと思われます。
スマホではSurfaceViewにより上手くディスプレイ装置の動作に合わせたタイミング調整が行われると思われる
しかし、GoやQuestでは画面を表示する仕組みがAndroid用のスマホと異なり SurfaceViewが使えません。
そのため自動的に上手くやってもらえず、大抵の場合 動画再生機能の動作タイミングとディスプレイ装置のタイミングが合わず 表示されないフレームが発生してしまいます。
QuestではSurfaceViewが使えず 1リフレッシュ期間に2フレーム表示しようとしてしまうことがある
Oculus GoやQuestにおいて60Hz 60fpsで完全な再生をするには SurfaceViewに代わって アプリ側にタイミング調整の仕組みが必要となりますが、有名なassetのAVPro Ver1.11.5やOculus Integrationに含まれるプレイヤーアプリのサンプルではディスプレイ装置に合わせたタイミング調整が実装されていないため50fps程度の表示となってしまいます。
Android用のアプリ開発においてAVProはとても有力なassetと思われますので、Oculus GoやQuest用アプリでも多く使われていると思われます。
60fpsサンプル動画
30fpsサンプル動画
これを60Hz で再生すれば見た目で簡単に評価できると思います。
■ 60Hz 60fps以外にも
・60Hzで30fpsの動画を再生した際に きっちり2フレームずつ表示できるか
・72Hzで60fpsの動画を再生した際に 5フレーム表示した後 1フレーム休む と言った均等なフレーム割り当てができるか
・90Hzで60fpsの動画を150％で再生 早回しでもきれいに再生できるか
・60Hzで90fpsの動画を67％で再生 スロー再生でもきれいに再生できるか
・必ずタイミングはずれてくるので 10～20秒くらいに一度 意図的にフレームを飛ばしたり 重複させる処理が適切に行えているか
と言った評価ポイントがあります。
■ アマレコVRの最大fps
90Hz 90fpsまでは可能ですが、動画再生機能の上限が今のところ100fps弱なので120Hz 120fpsの再生はできません。
120Hz 60fpsでの再生は可能ですが 動いているものがぶれて見える（60Hzで 30fpsの動画を再生した場合と同じ印象）ため 60Hz 60fpsで再生した方が 見やすいです。
アマレコVR Ver2.1.7 アルファ7 画像処理完成版 公開
背景透過等の画像処理の完成版です。メインプレイヤーで再生している動画の（動かない）背景部を透明にします。
そのほかOculus SDKがハンドトラッキングへ対応したのでパススルー機能と同時に使えるようになりました。また、コメント欄で公開したクロマキー合成も含まれます。
いずれも、パススルー映像にVR動画の被写体を合成したり、VRonVRにより複数の動画を合成し、さらに自分の手を合成するといった 一歩踏み込んだミックスドリアリティ体験が可能となります。
VRonVRで2D動画を背景にして手前に被写体を合成する例
今までのアマレコVRではVR動画を背景にして手前に2D動画といった構成しかできず、2D動画のスクリーンを大きく表示することができませんでしたが（背景が隠れてしまう）、
VRonVRにより巨大な2D動画のスクリーンを背景に 手前にVR動画といった構成が可能になっています。
もちろん背景をVR動画、手前もVR動画も可能です。
そして、VR動画を手前に表示するのに重要となるのが VR動画の背景を透明にする仕組みです。この例ではRobust Video Mattingを使って背景を緑にした動画を作成し、アマレコVRのクロマキー合成を使っています。
Robust Video Matting程ではありませんが、簡易的に済ます場合はアマレコVRの背景透過処理を使うこともできます。
１．内容
【更新内容 アマレコVRアプリ】
・画像処理追加（背景透過、クロマキー合成、シルエットモード）
・ハンドトラッキング復活
・サブカメラ画面へ横型を追加
・内蔵ストレージの動画ファイルへアクセスできなくなっていたのを修正(Ver2.1.3から使えなくなっていた)
・サーバーはVer2.1.3から変更なし
・Oculus software v35が必要
【Ver2.1.5から画像処理の更新内容】
・基本的な性能向上（背景は消えやすく、被写体は消えにくくなりました）
・背景画像の作成に時間がかかるようになりました
・パフォーマンスが低下しました（Quest 1では 60fpsを下回る）
・設定項目追加（背景サンプリング時間、レンダリング解像度）
・クロマキー合成、シルエットモード追加
・背景透過処理へ メイン画面設定の透明度が反映されるようになりました
【既知の不具合】
・アプリ起動時などファイルリスト読込中に リスト内検索等をすると 操作不能に陥る
（リストの読み込みが終わるのを待ってから操作してください チャンネル部に読込件数が表示されている間は待つ）
・サーバー側でサムネイルの自動作成をすると アプリが止まってしまうことがある
（サムネイルの作成が終わってから使うようにする）
【Ver2.1.1 アルファ2と同じ内容】
・サブカメラ機能の映像ソースを選択する[CL]、[CR]は機能しません
・ハンドトラッキングに関する機能は使えません(Ver2.1.7から使えるようになりました)
・アマレコVRアプリによりサムネイル画像を作成すると白っぽい画像になってしまいます (Ver2.1.3で対応しました)
２．使い方
・ 次の記事と合わせて見てください。
Ver2.1.0 アルファ1
Ver2.1.1 アルファ2
Ver2.1.3 アルファ3
・アマレコVR自体の使い方は オンラインヘルプを見てください。
・ベータ版、アルファ1、アルファ2、アルファ3とは異なるアプリとしてインストールされます。
・アマレコVRサーバーはアルファ3と同じです。
２．１．画像処理
メイン画面設定の画像処理メニューから設定します。
※ メイン画面設定は頻繁に使う為 アマレコVR設定のボタン機能で[メイン画面設定を表示]を割り当てることをお勧めします。
■画像処理メニュー
・処理なし
画像処理を行いません。
・背景透過
画像処理により映像内の（動かない）背景部を透明にします。
・クロマキー合成
画像処理により指定した背景色を透明にします。
・背景バッファクリア
現在の画像処理の解析結果を破棄し、ゼロから構築しなおします。また、クロマキー合成の背景色をクリアします。
・シルエットモード
メイン画面の映像を単色で塗りつぶします。
メイン画面設定の透明度が反映されます。
エッジがクリアでないと 何が表示されているかわからないので、クロマキー合成か背景透過の輪郭解像度を1024にして使って下さい。
※ 色はサーバー側の設定ファイルで変更できます（後述）。
※ 画像処理を使うには アマレコVRアプリのプレイヤー設定でAmaRec Playerを選択してください。（初期値はAmaRec Playerなので通常はそのままでOKです）
AVProでは利用できません。
■背景透過
■背景透過メニュー
・ぼかし（時間）
過去のフレームと加算し映像をぼかす度合いを設定します。
ノイズや画質、照明の影響を軽減し安定した処理結果が期待できます。
数値が小さいと背景画像の作成に時間がかかるため、なかなか背景が透明になりません。
数値が大きいほど映像のノイズや不安定な照明、差分フレームとキーフレームの画質差などを軽減し背景の判定がやり易くなります。
逆に、被写体の動きの検出が難しくなるため 動きの少ない被写体も背景と誤判定され消え易くなってしまいます。
また、数値が大きいと 新しいフレームの影響が少なくなるため タイムラグが生じます。
・背景閾値
低いほど被写体に有利な判定になります。代わりに背景の判定が上手くできず透明になりません。
高いほど背景に有利な代わりに 被写体が誤判定され消えやすくなります。
・背景時間
3なら 3秒間変化が少ない領域を背景として拾います。
数値が低いほど 素早く背景画像を構築できますが、動きの少ない被写体も背景として拾ってしまいます。
数値を大きくすると 背景画像の構築に時間がかかる代わりに 被写体を拾い難くなります。
・解像度
処理結果（透明、不透明のマスクパターン）の解像度を選択します。
256は解像度が極めて低いため 輪郭を強くぼかして使います。
1024は解像度が高く輪郭をくっきり表示したい場合に使います。
※ 1024は処理に時間がかかるため 他の機能と併用すると60fpsを下回ります。
fpsの低下が目立つ場合は256を使って下さい。
・輪郭ぼかし、 輪郭サイズ
処理結果（マスクパターン）の輪郭を調整します。お好みで調整してください。
■クロマキー合成
・背景色
透明にする背景色を指定します。
具体的には 画像処理により指定した色に属する画面内で多く使われている色を検出し、透明にします。
自動は色を指定せず画面内で最も多く使われている色を背景色とします。
そのため、赤い服を着た人がカメラへ近づいて画面全体が赤くなると背景色が赤と判断されてしまう場合があります。
※ Ver2.1.6の青緑は廃止しました。Robust Video Mattingの初期背景色は緑で使えます。
・背景閾値
背景色と近い色を透明にする際の閾値です。
低いと背景に影があった場合に 影が見えてしまいます。
高いと被写体の一部が透明になってしまいます。
・輪郭サイズ
輪郭処理を行う大きさを指定します。
輪郭部は背景色の成分を除いて半透明にします。
※ Ver2.1.6と比べ 透明度を上げて ほぼ透明にしました。
２．２．ハンドトラッキング
Oculus Questのハンドトラッキングが「OpenXR」に正式対応したのでパススルー機能とハンドトラッキング機能を同時に利用できるようになりました。
アマレコVRのハンドトラキング機能に関する基本的な使い方はオンラインヘルプを参照してください。
今回からハンドトラッキングメニューが追加され 手のグラフィックを選択できます。
・パススルー透過：透明、カラー
手の形で穴を開け後ろのパススルー映像を見えるようにします。
また、スクリーンオブジェクトと干渉します（メイン画面を触れる）。
カラーの場合は、手の形でパススルー映像を着色します。
・非透過 半透明：黒、青
メインスクリーン等の上に半透明で手を表示します。
スクリーンオブジェクトとは干渉しません（常に手前に表示されます）。
※ 各色はサーバー側の設定ファイルで変更できます（後述）。
３．その他
■サブカメラ画面へ横型を追加
16:9よりさらに横に広い視野の[横型]を追加しました。
■色設定
次の色はサーバー側の設定ファイル AmaRecVRServer.iniをメモ帳で編集して変更できます。
また、変更した後はアプリを再起動しなくても、選択項目を変更した際に再度設定値をサーバーから読み込みます。
・画像処理：シルエットモードの色
・ハンドトラッキングの色
■背景透過処理へ 透明度が反映されるようになりました
画像処理を利用している場合も [メインスクリーンを半透明にする]をONにして、透明度を調整することができるようになりました。
半透明にすることでVRonVRの奥で再生している動画が見えなくなるのを防ぐことができます。
また、アルファマップAを使うと 視界の下半分にだけメイン画面を表示して、上半分へは表示しないなど メイン画面の表示範囲を制限することができます。
４．ダウンロード
・ アマレコVR Ver2.1.7 アルファ版7
・ アマレコVRサーバー Ver2.13
※ アマレコVRサーバーは更新なし
オンラインヘルプ Ver2.0.0
そのほかOculus SDKがハンドトラッキングへ対応したのでパススルー機能と同時に使えるようになりました。また、コメント欄で公開したクロマキー合成も含まれます。
いずれも、パススルー映像にVR動画の被写体を合成したり、VRonVRにより複数の動画を合成し、さらに自分の手を合成するといった 一歩踏み込んだミックスドリアリティ体験が可能となります。
— amaman (@amarectv)
VRonVRで2D動画を背景にして手前に被写体を合成する例
今までのアマレコVRではVR動画を背景にして手前に2D動画といった構成しかできず、2D動画のスクリーンを大きく表示することができませんでしたが（背景が隠れてしまう）、
VRonVRにより巨大な2D動画のスクリーンを背景に 手前にVR動画といった構成が可能になっています。
もちろん背景をVR動画、手前もVR動画も可能です。
そして、VR動画を手前に表示するのに重要となるのが VR動画の背景を透明にする仕組みです。この例ではRobust Video Mattingを使って背景を緑にした動画を作成し、アマレコVRのクロマキー合成を使っています。
Robust Video Matting程ではありませんが、簡易的に済ます場合はアマレコVRの背景透過処理を使うこともできます。
１．内容
【更新内容 アマレコVRアプリ】
・画像処理追加（背景透過、クロマキー合成、シルエットモード）
・ハンドトラッキング復活
・サブカメラ画面へ横型を追加
・内蔵ストレージの動画ファイルへアクセスできなくなっていたのを修正(Ver2.1.3から使えなくなっていた)
・サーバーはVer2.1.3から変更なし
・Oculus software v35が必要
【Ver2.1.5から画像処理の更新内容】
・基本的な性能向上（背景は消えやすく、被写体は消えにくくなりました）
・背景画像の作成に時間がかかるようになりました
・パフォーマンスが低下しました（Quest 1では 60fpsを下回る）
・設定項目追加（背景サンプリング時間、レンダリング解像度）
・クロマキー合成、シルエットモード追加
・背景透過処理へ メイン画面設定の透明度が反映されるようになりました
【既知の不具合】
・アプリ起動時などファイルリスト読込中に リスト内検索等をすると 操作不能に陥る
（リストの読み込みが終わるのを待ってから操作してください チャンネル部に読込件数が表示されている間は待つ）
・サーバー側でサムネイルの自動作成をすると アプリが止まってしまうことがある
（サムネイルの作成が終わってから使うようにする）
【Ver2.1.1 アルファ2と同じ内容】
・サブカメラ機能の映像ソースを選択する[CL]、[CR]は機能しません
・ハンドトラッキングに関する機能は使えません(Ver2.1.7から使えるようになりました)
・アマレコVRアプリによりサムネイル画像を作成すると白っぽい画像になってしまいます (Ver2.1.3で対応しました)
２．使い方
・ 次の記事と合わせて見てください。
Ver2.1.0 アルファ1
Ver2.1.1 アルファ2
Ver2.1.3 アルファ3
・アマレコVR自体の使い方は オンラインヘルプを見てください。
・ベータ版、アルファ1、アルファ2、アルファ3とは異なるアプリとしてインストールされます。
・アマレコVRサーバーはアルファ3と同じです。
【アマレコVR パススルー実験 アルファ版 まとめ】
Ver2.1.0 アルファ1 2021-09-03 パススルー実験版 （アルファ版）
Ver2.1.1 アルファ2 2021-10-07 パススルー実験版 リアルスケールになった
Ver2.1.2 アルファ3 2021-10-10 VRonVR試作版
Ver2.1.3 アルファ3 2021-11-15 VRonVR パススルーAPIが正式版になった 円周魚眼パラメータ サーバー更新
Ver2.1.4 アルファ4 2021-11-20 画像処理試作版
Ver2.1.5 アルファ5 2021-11-27 画像処理試作版
Ver2.1.6 アルファ6 2021-12-14 クロマキー合成テスト版(コメント欄で公開)
Ver2.1.7 アルファ7 2021-12-28 画像処理完成版 ハンドトラッキング復活 ほぼベータ版
２．１．画像処理
メイン画面設定の画像処理メニューから設定します。
※ メイン画面設定は頻繁に使う為 アマレコVR設定のボタン機能で[メイン画面設定を表示]を割り当てることをお勧めします。
■画像処理メニュー
・処理なし
画像処理を行いません。
・背景透過
画像処理により映像内の（動かない）背景部を透明にします。
・クロマキー合成
画像処理により指定した背景色を透明にします。
・背景バッファクリア
現在の画像処理の解析結果を破棄し、ゼロから構築しなおします。また、クロマキー合成の背景色をクリアします。
・シルエットモード
メイン画面の映像を単色で塗りつぶします。
メイン画面設定の透明度が反映されます。
エッジがクリアでないと 何が表示されているかわからないので、クロマキー合成か背景透過の輪郭解像度を1024にして使って下さい。
※ 色はサーバー側の設定ファイルで変更できます（後述）。
※ 画像処理を使うには アマレコVRアプリのプレイヤー設定でAmaRec Playerを選択してください。（初期値はAmaRec Playerなので通常はそのままでOKです）
AVProでは利用できません。
■背景透過
【画像処理：背景透過処理 概要】
動きの少ない部分(前のフレームからの変化が少ない領域)を検出し背景画像を作成します。
一度のサンプリングでは背景画像の信頼性が低いので数秒間解析を続けて信頼性の高まった背景画像と現在のフレームを比較して透明にします。
・背景画像と一致する領域は背景と判断し 透明にします
・一致しない領域は被写体と判断し 不透明にします
・信頼性の低い領域は常に 不透明となります
解析処理は常に行われ 家具の位置が変わったり、シーンチェンジすると背景画像もアップデートされます。
基本的に被写体が映った映像から背景画像を作成しますので
被写体と被写体の周辺領域については背景画像の信頼性が高まるまで時間がかかります。
そのため、被写体周辺の背景が表示されてしまったり、被写体が退いた後もしばらく背景が表示されることがあります。
また、動きの少ない被写体が背景と判断されてしまい、消えてしまう場合があります。
■前提条件
屋内の固定カメラで撮影されたVR映像であることが前提となります。
・背景が一切動かない (とにかくこれが大事、手振れなどもないこと)
・照明が安定している (ロウソクや太陽光などはNG)
・画質が安定していること (ノイズが多い、差分フレームとキーフレームの画質差が激しいなどはNG)
・被写体は基本的に1つ (複数の場合は 被写体と被写体の間が不透明になる 課題)
・被写体が丸っこいこと (でっぱりがあると その周辺は不透明になってしまいます 課題)
・被写体が適度に動くこと (数秒間 止まられると 背景と判断されて透明になってしまう)
■良い結果が期待できるケース
・背景がCGの映像 (クロマキー撮影し、CGの背景と合成された映像や 全てCGの映像)
・背景が真っ黒な映像 (多少背景が映ってしまっても 影っぽく自然に見える)
■背景透過メニュー
・ぼかし（時間）
過去のフレームと加算し映像をぼかす度合いを設定します。
ノイズや画質、照明の影響を軽減し安定した処理結果が期待できます。
数値が小さいと背景画像の作成に時間がかかるため、なかなか背景が透明になりません。
数値が大きいほど映像のノイズや不安定な照明、差分フレームとキーフレームの画質差などを軽減し背景の判定がやり易くなります。
逆に、被写体の動きの検出が難しくなるため 動きの少ない被写体も背景と誤判定され消え易くなってしまいます。
また、数値が大きいと 新しいフレームの影響が少なくなるため タイムラグが生じます。
・背景閾値
低いほど被写体に有利な判定になります。代わりに背景の判定が上手くできず透明になりません。
高いほど背景に有利な代わりに 被写体が誤判定され消えやすくなります。
・背景時間
3なら 3秒間変化が少ない領域を背景として拾います。
数値が低いほど 素早く背景画像を構築できますが、動きの少ない被写体も背景として拾ってしまいます。
数値を大きくすると 背景画像の構築に時間がかかる代わりに 被写体を拾い難くなります。
・解像度
処理結果（透明、不透明のマスクパターン）の解像度を選択します。
256は解像度が極めて低いため 輪郭を強くぼかして使います。
1024は解像度が高く輪郭をくっきり表示したい場合に使います。
※ 1024は処理に時間がかかるため 他の機能と併用すると60fpsを下回ります。
fpsの低下が目立つ場合は256を使って下さい。
【処理能力】
Oculus Quest 2で4K,60fpsのVR動画を視聴（サブプレイヤー、3rdプレイヤーは停止、パススルーON、画像処理の設定は初期値）
・背景透過 解像度1024 のみ 60fps以上
・背景透過 解像度1024 と アルファマップA 約54fps
・背景透過 解像度1024 アルファマップAとB併用 約48fps
※ Oculus Quest 1で4K,60fpsのVR動画を視聴する場合は背景透過 解像度256のみでも約48fpsとなります。
・輪郭ぼかし、 輪郭サイズ
処理結果（マスクパターン）の輪郭を調整します。お好みで調整してください。
■クロマキー合成
・背景色
透明にする背景色を指定します。
具体的には 画像処理により指定した色に属する画面内で多く使われている色を検出し、透明にします。
自動は色を指定せず画面内で最も多く使われている色を背景色とします。
そのため、赤い服を着た人がカメラへ近づいて画面全体が赤くなると背景色が赤と判断されてしまう場合があります。
※ Ver2.1.6の青緑は廃止しました。Robust Video Mattingの初期背景色は緑で使えます。
・背景閾値
背景色と近い色を透明にする際の閾値です。
低いと背景に影があった場合に 影が見えてしまいます。
高いと被写体の一部が透明になってしまいます。
・輪郭サイズ
輪郭処理を行う大きさを指定します。
輪郭部は背景色の成分を除いて半透明にします。
※ Ver2.1.6と比べ 透明度を上げて ほぼ透明にしました。
２．２．ハンドトラッキング
Oculus Questのハンドトラッキングが「OpenXR」に正式対応したのでパススルー機能とハンドトラッキング機能を同時に利用できるようになりました。
アマレコVRのハンドトラキング機能に関する基本的な使い方はオンラインヘルプを参照してください。
今回からハンドトラッキングメニューが追加され 手のグラフィックを選択できます。
・パススルー透過：透明、カラー
手の形で穴を開け後ろのパススルー映像を見えるようにします。
また、スクリーンオブジェクトと干渉します（メイン画面を触れる）。
カラーの場合は、手の形でパススルー映像を着色します。
・非透過 半透明：黒、青
メインスクリーン等の上に半透明で手を表示します。
スクリーンオブジェクトとは干渉しません（常に手前に表示されます）。
※ 各色はサーバー側の設定ファイルで変更できます（後述）。
【ハンドトラッキングとVR動画の視差】
VR（3D映像）の仕組み上、VR動画やハンドトラッキングの手の表示、パススルー映像それぞれに視差があります。
それぞれの視差が合わないと一緒に観ることができません（視野闘争、視差闘争）。
アマレコVRではメイン画面設定のステレオ調整で視差の調整が可能です。
私が視聴したVR映像ではステレオ調整を+30から+60あたりにすることで 30cmから50cmほど手を伸ばしたあたりで視差が合いました。
また、メインスクリーンのスケールを50程度（50cm先にスクリーンを配置）にすると、両手を前に伸ばしたあたりでハンドトラッキングの手とメインスクリーンが干渉します。
・ポジトラを ON (パススルー映像を使う場合はポジショントラッキングをONにします。)
・スケールを 50程度
・ステレオ調整を +30から+60程度 （VR映像の内容や 何センチ先で合わせるかで変わります。）
・ハンドトラッキングメニューで[パススルー透過：透明]または、[パススルー透過：カラー]を選択 非透過ではスクリーンオブジェクトと干渉しません。
３．その他
■サブカメラ画面へ横型を追加
16:9よりさらに横に広い視野の[横型]を追加しました。
■色設定
次の色はサーバー側の設定ファイル AmaRecVRServer.iniをメモ帳で編集して変更できます。
また、変更した後はアプリを再起動しなくても、選択項目を変更した際に再度設定値をサーバーから読み込みます。
・画像処理：シルエットモードの色
・ハンドトラッキングの色
【アマレコVRサーバー設定ファイル AmaRecVRServer.ini】
[ImageProcessing]
rw.param_silhouette_color_string=#0000FF7F
[HandTracking]
rw.color.0=#00000000
rw.color.1=r255g232b202a160
rw.color.2=#33333377
rw.color.3=#3333EE77
※ 10進数で指定する場合はr,g,b,aの後に各数値
※ 16進数で指定する場合は#の後にrgbaの順に数値
■背景透過処理へ 透明度が反映されるようになりました
画像処理を利用している場合も [メインスクリーンを半透明にする]をONにして、透明度を調整することができるようになりました。
半透明にすることでVRonVRの奥で再生している動画が見えなくなるのを防ぐことができます。
また、アルファマップAを使うと 視界の下半分にだけメイン画面を表示して、上半分へは表示しないなど メイン画面の表示範囲を制限することができます。
４．ダウンロード
・ アマレコVR Ver2.1.7 アルファ版7
・ アマレコVRサーバー Ver2.13
※ アマレコVRサーバーは更新なし
オンラインヘルプ Ver2.0.0
アマレコVR Ver2.1.5 アルファ5 背景透過試作版 第二弾 公開
自動背景透過処理の試作版の第二弾です。
画像処理を改善しレスポンスの向上と背景と判断する部分が増えました。
黒いT字の被写体に対し 赤い輪郭のマスクパターンを作成したいけど、緑の領域が加わっていたのが改善されます。
１．導入
アマレコVR Ver2.1.3 アルファ3を使っていることが前提です。
まだの人はアルファ3の記事も合わせて観てください。
今回はアルファ5としてインストールされます。
アルファ3、アルファ4とは別アプリとしてインストールされます。
２．使い方
メイン画面設定の[画像処理]メニューから[自動背景透過]を選択してください。
あとはメインプレイヤーで再生されている映像を自動で処理します。
※ アマレコVRアプリのプレイヤー設定でAmaRec Playerを選択してください。（初期値はAmaRec Playerなので通常はそのままでOKです）
AVProでは利用できません。
※ アルファ4を利用していた場合でも 画像処理の設定が初期値の[処理なし]に戻っています。再度、[自動背景透過]を選択してください。
■画像処理メニュー
[ぼかし（時間）]
過去のフレームと加算し映像をぼかす度合いを設定します。
数値が大きいほど映像のノイズや不安定な照明、差分フレームとキーフレームの画質差などを軽減し背景の判定がやりやすくなります。
逆に、被写体の動きの検出がし難くなるため 動きの少ない被写体も背景と誤判定され消えやすくなってしまいます。
また、数値が大きいと 新しいフレームの影響が少なくなるため タイムラグが生じます。
[背景閾値]
低いほど被写体に有利な判定になります。代わりに背景の判定が上手くできず消えにくくなります。
高いほど背景に有利な代わりに 被写体が誤判定され消えやすくなります。
[輪郭ぼかし]と[輪郭サイズ]
判定結果（マスクパターン）の輪郭を調整します。お好みで調整してください。
[背景バッファクリア]
現在の解析結果を破棄し、ゼロから構築しなおします。設定の変更が反映されない場合にクリアしてください。
３．画像処理概要
アルファ4の記事を観てください
４．ダウンロード
・ アマレコVR Ver2.1.5 試作版
・ アマレコVRサーバー Ver2.13
※ アマレコVRサーバーは更新なし
新しいバージョン アマレコVR Ver2.1.7が公開されています。
画像処理を改善しレスポンスの向上と背景と判断する部分が増えました。
黒いT字の被写体に対し 赤い輪郭のマスクパターンを作成したいけど、緑の領域が加わっていたのが改善されます。
１．導入
アマレコVR Ver2.1.3 アルファ3を使っていることが前提です。
まだの人はアルファ3の記事も合わせて観てください。
今回はアルファ5としてインストールされます。
アルファ3、アルファ4とは別アプリとしてインストールされます。
２．使い方
メイン画面設定の[画像処理]メニューから[自動背景透過]を選択してください。
あとはメインプレイヤーで再生されている映像を自動で処理します。
※ アマレコVRアプリのプレイヤー設定でAmaRec Playerを選択してください。（初期値はAmaRec Playerなので通常はそのままでOKです）
AVProでは利用できません。
※ アルファ4を利用していた場合でも 画像処理の設定が初期値の[処理なし]に戻っています。再度、[自動背景透過]を選択してください。
■画像処理メニュー
[ぼかし（時間）]
過去のフレームと加算し映像をぼかす度合いを設定します。
数値が大きいほど映像のノイズや不安定な照明、差分フレームとキーフレームの画質差などを軽減し背景の判定がやりやすくなります。
逆に、被写体の動きの検出がし難くなるため 動きの少ない被写体も背景と誤判定され消えやすくなってしまいます。
また、数値が大きいと 新しいフレームの影響が少なくなるため タイムラグが生じます。
[背景閾値]
低いほど被写体に有利な判定になります。代わりに背景の判定が上手くできず消えにくくなります。
高いほど背景に有利な代わりに 被写体が誤判定され消えやすくなります。
[輪郭ぼかし]と[輪郭サイズ]
判定結果（マスクパターン）の輪郭を調整します。お好みで調整してください。
[背景バッファクリア]
現在の解析結果を破棄し、ゼロから構築しなおします。設定の変更が反映されない場合にクリアしてください。
３．画像処理概要
アルファ4の記事を観てください
４．ダウンロード
・ アマレコVR Ver2.1.5 試作版
・ アマレコVRサーバー Ver2.13
※ アマレコVRサーバーは更新なし
新しいバージョン アマレコVR Ver2.1.7が公開されています。
アマレコVR Ver2.1.3 アルファ3 VRonVR 公開
パススルー機能が正式版になりました。また、アルファマップを使って2つのVR動画を視聴するVRonVR機能と円周魚眼スクリーンのパラメータ追加、その他 細々とした調整となっています。
クロマキー合成については 指定した色を透明化する形で実装する予定でしたが クロマキー合成用のVR映像が一般的でないため見送ることにしました。
１．内容
【更新内容 アマレコVRアプリ】
・通信プロトコルを213へ変更
・Oculus Passthrough APIが正式版になりました
・VRonVR用の3rdプレイヤーを追加
・円周魚眼スクリーン用のパラメータを追加
・サブプレイヤー、3rdプレイヤーへも白黒オプションを追加
・上下反転オプションを追加
・ポジショントラッキングのON、OFFオプションを追加(初期状態OFF)
・PCマウスのボタン設定を拡張
・アルファマップの移動縦を変更（平面移動から回転へ変更）
・アルファマップを全球の前半分へ張り付けるように変更
・UI画面表示時に 向きリセットしないように変更
・アプリ側で作ったサムネイル画像が白くならないようにしました
・メイン画面設定の再生時ロードを廃止
・一時停止したまま 次の動画を再生したときのアイコン表示を修正
・マウス操作の際 ファイル画面のファイルリストで複数項目が選択できないことがあるのを修正
・サブ画面の表示/非表示が使えなかったのを修正
【更新内容 アマレコVRサーバー】
・ネットワークに関する設定を追加（最大ストリーム数、動画読込キャッシュ）
・動画読込キャッシュワーク変更
・検索処理で アルファベットの大文字と小文字を区別しないように変更
・検索処理で 半角スペースとアンダースコア、ハイフンを区別しないように変更
・通信プロトコル更新(213) 通信プロトコル200と上位互換
・アルファマップ追加
【既知の不具合】
・アプリ起動時などファイルリスト読込中に リスト内検索等をすると 操作不能に陥る
（リストの読み込みが終わるのを待ってから操作してください チャンネル部に読込件数が表示されている間は待つ）
・サーバー側でサムネイルの自動作成をすると アプリが止まってしまうことがある
（サムネイルの作成が終わってから使うようにする）
【Ver2.1.1 アルファ2と同じ内容】
・サブカメラ機能の映像ソースを選択する[CL]、[CR]は機能しません
・ハンドトラッキングに関する機能は使えません
・パススルー機能は Oculus software v31以降でないと使えません (Ver2.13から Oculus software v34以降が必要)
・Oculus Quest 1でも利用可能です
・アマレコVRアプリによりサムネイル画像を作成すると白っぽい画像になってしまいます (Ver2.13で対応しました)
２．使い方
・ Ver2.1.0 アルファ1、 Ver2.1.1 アルファ2の記事と合わせて見てください。
・アマレコVR自体の使い方は オンラインヘルプを見てください。
・ベータ版、アルファ1、アルファ2とは異なるアプリとしてインストールされます。
・Ver2.1.2 アルファ3 試作版がインストールされている場合は 同じアプリとして上書きされます。
・アマレコVRサーバーも更新されています。
※ADBコマンドで開発者向けの機能を有効にする必要があります。Ver2.1.0 アルファ1の準備の項を参照してください。
Oculus software v34とアマレコVR Ver2.1.3からパススルー機能が正式版となりました。
ADBコマンドなしでパススルー機能を利用できます。
※アルファマップに関するファイルは今回からサーバー側に同梱しています。アプリには同梱されていません。アルファマップの内容は Ver2.11アルファ2に同梱していたものと同じです。
２．１．VRonVR
新しくVR動画（通常の2D動画も可）を再生するための3rdプレイヤーを追加しました。
メイン画面の右側のメニューで[3rd]を選択すると 3rdプレイヤーで動画を再生します。
■映像の合成
メインプレイヤーと3rdプレイヤーの映像を メイン画面設定にあるアルファマップAで合成します。
アルファマップAの白い部分がメインプレイヤー、黒い部分が3rdプレイヤーの映像になります。
その結果とパススルー映像がアルファマップBで合成されます。
■3rdプレイヤーの操作
コンソール画面で3rdプレイヤーに関する操作ができます。
・プレイヤーの選択
・3rdプレイヤーの音量
・サブカメラの映像ソース選択 [CM]メインプレイヤーの映像、[C3]3rdプレイヤーの映像
・3rdプレイヤー用のスクリーンの向き調整
・3rdプレイヤー用のスクリーンのZ位置調整
・3rdプレイヤー用のスクリーンのステレオ調整
・[向き連動]をONにするとメイン画面の向き調整（メイン画面のチルトなど）と一緒に動くようになります。
・3rdプレイヤーの再生速度
・3rdプレイヤーのリピートモード
■ボタン機能
3rdプレイヤーに関するボタン機能が追加されています。
ホイール機能
■要求スペックと推奨環境
Oculus Quest 1でも動作はしますが、スペック的にQuest2でないと厳しいです。
Quest1は4K 60fpsの動画 1つで ほぼ限界に達します。
Quest2の場合は4KオーバーのVR動画も利用できますが、VRonVRで複数プレイヤーを使うとリソース不足でアプリケーションが強制終了される場合があります。
Quest2であっても複数プレイヤーを使う場合は 4K 60fpsのVR動画までの利用を推奨します。
また、アプリ側でサムネイルを自動生成したり、ファイル画面のサムネイル簡易再生等も加わるとリソース不足になる場合が出てきます。
自動生成はサーバー側で行うようにしてください。簡易再生にも制限を加えてください。
【Quest2で複数プレイヤーを使う場合の推奨環境】
・メインプレイヤー： 4K 60fps以内
・サブプレイヤー： FullHD 60fps以内
・3rdプレイヤー： 4K 60fps以内
・サムネイル簡易再生： 縦2160を超える動画を再生しない または [サムネイルプレイヤーを使う]をOFFにする (アプリの設定画面の サムネイル設定)
・サムネイル自動生成： サーバーの設定画面で [FFMPEGを使う]をON
■4ストリームに対応しました
Ver2.1.2 試作版では3ストリームまででしたが、Ver2.1.3から4ストリームに対応しました。
メインプレイヤー、サブプレイヤー、3rdプレイヤー、サムネイルプレイヤーを同時に利用できます。
■その他
3rdプレイヤーはVRフォーマット等を手動で設定できません。ファイル名へタグを入れたり、画像サイズから自動判別できるように準備を徹底してください。
サブプレイヤーと3rdプレイヤーは現状AVProで再生するため欠落フレームが生じます。60fpsの動画でも50fps程度の再生となります。
２．２．円周魚眼パラメータ
アマレコVRは2019年ころの日本で出回っていた円周魚眼VR動画に（見た目で）合わせていましたが、
最近異なる円周魚眼動画があるようなのでパラメータで調整できるようにしました。
100は今まで通り
最近のものはスケールを75あたりにすると 歪みが少なく視聴できると思います。
また、200度の魚眼レンズで作成されたVR動画ではスケール-140、PosZ-40あたりでしょうか。
■円周魚眼パラメータ
・スケール
プラス側で調整するとXYZのスケールを調整します。
50ならXYZそれぞれ半分の大きさのスクリーン形状に映像を投影して視聴します。
マイナス側にすると Zスケールのみを調整します（スクリーン形状の厚みだけを調整します）。
-140なら 厚みが40％増します。
・PosZ
カメラとスクリーンの距離を調整します。
0が標準
50なら50cmカメラへ近づける
-50なら50cmカメラから遠くへ配置します。
・プリセット
円周魚眼パラメータメニューからプリセットを変更できます。
■タグ
スクリーン形状を指定する際の-screen[FishEye]へ円周魚眼パラメータを追加できます。
パラメータをいくつにしたらいいか分かってきたらファイル名へタグを入れて 使いこなしてください。
省略した場合はアプリ上で最後に手動設定した値となります。
画像サイズや比率から自動判定する場合も同様に円周魚眼パラメータを利用できます。
３．その他
■ポジショントラッキングのON、OFFオプションを追加
基本的にVRとしてのポジショントラッキングは常に有効です。
メイン画面のポジショントラッキングをOFFにすると
ポジショントラッキングを行いつつ 映像を投影するスクリーンの位置とHMDの位置を一定に保つように動作します。
いままでは常にONの状態でしたが、今回からOFFにできるようになりました。
また、初期状態をOFFとしました。
VR映像を視聴する場合は HMDの位置がスクリーンの中心からずれることで映像が歪みますので 基本的にはポジショントラッキングをOFFにすることをお勧めします。
パススルー映像にスクリーンの位置を合わせたい場合は ポジショントラッキングをONにしてください。
■白黒オプション、上下反転オプション
プレイヤー毎に白黒（モノクローム化）や表示を上下反転できるようになりました。
■再生時ロードを廃止
メイン画面設定にあった 動画をメインプレイヤーで再生した際に メイン画面の位置をロードするかどうかのオプションを廃止しました。
代わりに、動画ファイルに位置指定タグがある場合はその位置へ（一時的に変更されます）、
タグが無い場合は最後に手動設定した位置へ（一時的に変更されていた場合は戻ります）となります。
同様に以下の項目において タグがある場合は一時的に変更され、タグが無い場合は最後に手動設定した状態に戻ります。
・スクリーン位置設定
・ステレオ設定
・YUVレンジ設定
・クロップ設定
・円周魚眼パラメータ
■PCマウスのボタン機能が拡張されています。
サイドボタンを押しながら 他のオプションボタンを押した場合へ機能を割り当てることができます。
４．サーバー
ネットワークに関する設定が追加されていますが、基本的にはそのまま使ってください。
・最大ストリーム数は4で使ってください。
・動画読込キャッシュ バッファサイズ
一度にストレージから読み込むバイト数。
小さく設定するとHDD等の場合にストレージの読み込み性能を発揮できません。
大きくすると 小回りが利かなくなり レスポンスが悪くなります。
通常1MBのまま利用してください。
・動画読込キャッシュ バッファ数
ストリーム毎に[バッファサイズ] x [バッファ数] 分のメモリを確保します。
バッファに空きがある場合は 先読みします。
先読みができていると 指定秒送りの際にストレージへのアクセスを省略できるため 僅かにレスポンスが向上するかもしれません。
2以上に設定してください。
・動画読込キャッシュ プロテクト
使い終わったバッファを先読みで上書きされないように保護するバッファ数。
バッファに残っていると 指定秒戻しの際にストレージへのアクセスを省略できるため 僅かにレスポンスが向上するかもしれません。
0以上に設定してください。
通常、プレイヤー側でストリーミング再生の為のバッファリングを行っていますので、その範囲内でシークする場合は（サーバー側のキャッシュと関係なく）素早く処理されます。
プレイヤー側のバッファリングから外れた場合に サーバー側のキャッシュが機能します。
■導入
Ver2.1.1 アルファ2以降を使っている場合はAmaRecVRServer.exeだけ上書きしてください。
アルファ版を使っていない場合はAmaRecVRServer.exeeとalphamapフォルダをコピーしてください。
初めて使う場合はAmaRecVRServer213フォルダ内のファイル全てをコピーしてください。
■その他
Ver200と上位互換です。アマレコVRアプリ Ver2.0.0からVer2.1.3まで利用できます。
ネットワーク（動画読み込みキャッシュ）に関する設定の変更はサーバープログラムの再起動が必要です。
いままでアプリ側に含めていたアルファマップに関するファイルをサーバー側に同梱しています。内容はアプリ Ver2.1.1アルファ2に同梱したものと同じです。
検索処理で アルファベットの大文字と小文字を区別しないようになりました。
検索処理で 半角スペースとアンダースコア、ハイフンを区別しないようになりました。
５．ダウンロード
・ アマレコVR Ver2.1.3 アルファ3
・ アマレコVRサーバー Ver2.13
オンラインヘルプ Ver2.0.0
新しいバージョン アマレコVR Ver2.1.7が公開されています。
クロマキー合成については 指定した色を透明化する形で実装する予定でしたが クロマキー合成用のVR映像が一般的でないため見送ることにしました。
１．内容
【更新内容 アマレコVRアプリ】
・通信プロトコルを213へ変更
・Oculus Passthrough APIが正式版になりました
・VRonVR用の3rdプレイヤーを追加
・円周魚眼スクリーン用のパラメータを追加
・サブプレイヤー、3rdプレイヤーへも白黒オプションを追加
・上下反転オプションを追加
・ポジショントラッキングのON、OFFオプションを追加(初期状態OFF)
・PCマウスのボタン設定を拡張
・アルファマップの移動縦を変更（平面移動から回転へ変更）
・アルファマップを全球の前半分へ張り付けるように変更
・UI画面表示時に 向きリセットしないように変更
・アプリ側で作ったサムネイル画像が白くならないようにしました
・メイン画面設定の再生時ロードを廃止
・一時停止したまま 次の動画を再生したときのアイコン表示を修正
・マウス操作の際 ファイル画面のファイルリストで複数項目が選択できないことがあるのを修正
・サブ画面の表示/非表示が使えなかったのを修正
【更新内容 アマレコVRサーバー】
・ネットワークに関する設定を追加（最大ストリーム数、動画読込キャッシュ）
・動画読込キャッシュワーク変更
・検索処理で アルファベットの大文字と小文字を区別しないように変更
・検索処理で 半角スペースとアンダースコア、ハイフンを区別しないように変更
・通信プロトコル更新(213) 通信プロトコル200と上位互換
・アルファマップ追加
【既知の不具合】
・アプリ起動時などファイルリスト読込中に リスト内検索等をすると 操作不能に陥る
（リストの読み込みが終わるのを待ってから操作してください チャンネル部に読込件数が表示されている間は待つ）
・サーバー側でサムネイルの自動作成をすると アプリが止まってしまうことがある
（サムネイルの作成が終わってから使うようにする）
【Ver2.1.1 アルファ2と同じ内容】
・サブカメラ機能の映像ソースを選択する[CL]、[CR]は機能しません
・ハンドトラッキングに関する機能は使えません
・
・Oculus Quest 1でも利用可能です
・
２．使い方
・ Ver2.1.0 アルファ1、 Ver2.1.1 アルファ2の記事と合わせて見てください。
・アマレコVR自体の使い方は オンラインヘルプを見てください。
・ベータ版、アルファ1、アルファ2とは異なるアプリとしてインストールされます。
・Ver2.1.2 アルファ3 試作版がインストールされている場合は 同じアプリとして上書きされます。
・アマレコVRサーバーも更新されています。
※
Oculus software v34とアマレコVR Ver2.1.3からパススルー機能が正式版となりました。
ADBコマンドなしでパススルー機能を利用できます。
※アルファマップに関するファイルは今回からサーバー側に同梱しています。アプリには同梱されていません。アルファマップの内容は Ver2.11アルファ2に同梱していたものと同じです。
２．１．VRonVR
新しくVR動画（通常の2D動画も可）を再生するための3rdプレイヤーを追加しました。
メイン画面の右側のメニューで[3rd]を選択すると 3rdプレイヤーで動画を再生します。
【プレイヤー仕様】
メインプレイヤー：
VR動画、2D動画、3D動画
基本的には正面へ表示
滑らかな再生ができるAmaRec Player利用可
サブプレイヤー：
2D動画、3D動画
自由に配置(大きさ調整)可能
AVProのみ(欠落フレーム有り)
3rdプレイヤー：
VR動画、2D動画、3D動画
メインプレイヤーの映像と合成するのに使う
AVProのみ(欠落フレーム有り)
■映像の合成
メインプレイヤーと3rdプレイヤーの映像を メイン画面設定にあるアルファマップAで合成します。
アルファマップAの白い部分がメインプレイヤー、黒い部分が3rdプレイヤーの映像になります。
その結果とパススルー映像がアルファマップBで合成されます。
■3rdプレイヤーの操作
コンソール画面で3rdプレイヤーに関する操作ができます。
・プレイヤーの選択
・3rdプレイヤーの音量
・サブカメラの映像ソース選択 [CM]メインプレイヤーの映像、[C3]3rdプレイヤーの映像
・3rdプレイヤー用のスクリーンの向き調整
・3rdプレイヤー用のスクリーンのZ位置調整
・3rdプレイヤー用のスクリーンのステレオ調整
・[向き連動]をONにするとメイン画面の向き調整（メイン画面のチルトなど）と一緒に動くようになります。
・3rdプレイヤーの再生速度
・3rdプレイヤーのリピートモード
■ボタン機能
3rdプレイヤーに関するボタン機能が追加されています。
ホイール機能
■要求スペックと推奨環境
Oculus Quest 1でも動作はしますが、スペック的にQuest2でないと厳しいです。
Quest1は4K 60fpsの動画 1つで ほぼ限界に達します。
Quest2の場合は4KオーバーのVR動画も利用できますが、VRonVRで複数プレイヤーを使うとリソース不足でアプリケーションが強制終了される場合があります。
Quest2であっても複数プレイヤーを使う場合は 4K 60fpsのVR動画までの利用を推奨します。
また、アプリ側でサムネイルを自動生成したり、ファイル画面のサムネイル簡易再生等も加わるとリソース不足になる場合が出てきます。
自動生成はサーバー側で行うようにしてください。簡易再生にも制限を加えてください。
【Quest2で複数プレイヤーを使う場合の推奨環境】
・メインプレイヤー： 4K 60fps以内
・サブプレイヤー： FullHD 60fps以内
・3rdプレイヤー： 4K 60fps以内
・サムネイル簡易再生： 縦2160を超える動画を再生しない または [サムネイルプレイヤーを使う]をOFFにする (アプリの設定画面の サムネイル設定)
・サムネイル自動生成： サーバーの設定画面で [FFMPEGを使う]をON
■4ストリームに対応しました
Ver2.1.2 試作版では3ストリームまででしたが、Ver2.1.3から4ストリームに対応しました。
メインプレイヤー、サブプレイヤー、3rdプレイヤー、サムネイルプレイヤーを同時に利用できます。
【ストリーム仕様】
ストリーム1：メインプレイヤー
ストリーム2：サブプレイヤー
ストリーム3：3rdプレイヤー
ストリーム4：サムネイルプレイヤー
■その他
3rdプレイヤーはVRフォーマット等を手動で設定できません。ファイル名へタグを入れたり、画像サイズから自動判別できるように準備を徹底してください。
サブプレイヤーと3rdプレイヤーは現状AVProで再生するため欠落フレームが生じます。60fpsの動画でも50fps程度の再生となります。
２．２．円周魚眼パラメータ
アマレコVRは2019年ころの日本で出回っていた円周魚眼VR動画に（見た目で）合わせていましたが、
最近異なる円周魚眼動画があるようなのでパラメータで調整できるようにしました。
100は今まで通り
最近のものはスケールを75あたりにすると 歪みが少なく視聴できると思います。
また、200度の魚眼レンズで作成されたVR動画ではスケール-140、PosZ-40あたりでしょうか。
■円周魚眼パラメータ
・スケール
プラス側で調整するとXYZのスケールを調整します。
50ならXYZそれぞれ半分の大きさのスクリーン形状に映像を投影して視聴します。
マイナス側にすると Zスケールのみを調整します（スクリーン形状の厚みだけを調整します）。
-140なら 厚みが40％増します。
・PosZ
カメラとスクリーンの距離を調整します。
0が標準
50なら50cmカメラへ近づける
-50なら50cmカメラから遠くへ配置します。
・プリセット
円周魚眼パラメータメニューからプリセットを変更できます。
【円周魚眼パラメータ 初期プリセット】
プリセット１：スケール=-140、PosZ=-40 (200度魚眼レンズ)
プリセット2：スケール=75、PosZ=0 (最近の円周魚眼)
プリセット3：スケール=100、PosZ=0 (古い円周魚眼)
■タグ
スクリーン形状を指定する際の-screen[FishEye]へ円周魚眼パラメータを追加できます。
パラメータをいくつにしたらいいか分かってきたらファイル名へタグを入れて 使いこなしてください。
省略した場合はアプリ上で最後に手動設定した値となります。
画像サイズや比率から自動判定する場合も同様に円周魚眼パラメータを利用できます。
【例】
#tag "[魚]" "-layout[sbs] -screen[FishEye]"
#tag "[魚A]" "-layout[sbs] -screen[FishEye100]"
#tag "[魚B]" "-layout[sbs] -screen[FishEye75]"
#tag "[MKX200]" "-layout[sbs] -screen[FishEye-140pz-40]"
ファイル名に [魚] が含まれていたら 最後に手動設定したパラメータで 円周魚眼スクリーンを使います
ファイル名に [魚A] が含まれていたら 今まで通りの円周魚眼スクリーンを使います
ファイル名に [魚B] が含まれていたら 75％の円周魚眼スクリーンを使います
ファイル名に [MKX200] が含まれていたら 厚み140％の円周魚眼スクリーンを 40cm遠くへ配置します
３．その他
■ポジショントラッキングのON、OFFオプションを追加
基本的にVRとしてのポジショントラッキングは常に有効です。
メイン画面のポジショントラッキングをOFFにすると
ポジショントラッキングを行いつつ 映像を投影するスクリーンの位置とHMDの位置を一定に保つように動作します。
いままでは常にONの状態でしたが、今回からOFFにできるようになりました。
また、初期状態をOFFとしました。
VR映像を視聴する場合は HMDの位置がスクリーンの中心からずれることで映像が歪みますので 基本的にはポジショントラッキングをOFFにすることをお勧めします。
パススルー映像にスクリーンの位置を合わせたい場合は ポジショントラッキングをONにしてください。
■白黒オプション、上下反転オプション
プレイヤー毎に白黒（モノクローム化）や表示を上下反転できるようになりました。
■再生時ロードを廃止
メイン画面設定にあった 動画をメインプレイヤーで再生した際に メイン画面の位置をロードするかどうかのオプションを廃止しました。
代わりに、動画ファイルに位置指定タグがある場合はその位置へ（一時的に変更されます）、
タグが無い場合は最後に手動設定した位置へ（一時的に変更されていた場合は戻ります）となります。
同様に以下の項目において タグがある場合は一時的に変更され、タグが無い場合は最後に手動設定した状態に戻ります。
・スクリーン位置設定
・ステレオ設定
・YUVレンジ設定
・クロップ設定
・円周魚眼パラメータ
■PCマウスのボタン機能が拡張されています。
サイドボタンを押しながら 他のオプションボタンを押した場合へ機能を割り当てることができます。
４．サーバー
ネットワークに関する設定が追加されていますが、基本的にはそのまま使ってください。
・最大ストリーム数は4で使ってください。
・動画読込キャッシュ バッファサイズ
一度にストレージから読み込むバイト数。
小さく設定するとHDD等の場合にストレージの読み込み性能を発揮できません。
大きくすると 小回りが利かなくなり レスポンスが悪くなります。
通常1MBのまま利用してください。
・動画読込キャッシュ バッファ数
ストリーム毎に[バッファサイズ] x [バッファ数] 分のメモリを確保します。
バッファに空きがある場合は 先読みします。
先読みができていると 指定秒送りの際にストレージへのアクセスを省略できるため 僅かにレスポンスが向上するかもしれません。
2以上に設定してください。
・動画読込キャッシュ プロテクト
使い終わったバッファを先読みで上書きされないように保護するバッファ数。
バッファに残っていると 指定秒戻しの際にストレージへのアクセスを省略できるため 僅かにレスポンスが向上するかもしれません。
0以上に設定してください。
通常、プレイヤー側でストリーミング再生の為のバッファリングを行っていますので、その範囲内でシークする場合は（サーバー側のキャッシュと関係なく）素早く処理されます。
プレイヤー側のバッファリングから外れた場合に サーバー側のキャッシュが機能します。
【レスポンス】
実際に計測したわけではありませんが 感覚的なレスポンスは
(1) プレイヤーのバッファリング内でのシーク ：レスポンス 0.1秒
(2) サーバーキャッシュにヒット ：レスポンス 0.9秒
(3) サーバーキャッシュミス ストレージから読み込む ：レスポンス 1.0秒
(1)が圧倒的に早いのに対し (2)と(3)の違いは僅かとおもわれますので 読み込みキャッシュの設定を増やしても体感できるほどの効果は期待できません。
【設定例】
・標準
サイズ:1MB
数:32個
プロテクト:8個
※ キャッシュワーク用に メモリーを約128MB使います。（[バッファサイズ] x [バッファ数] x [ストリーム数]）
・最小構成
サイズ:1MB
数:2個
プロテクト:0個
※ サーバー側のメモリーを節約したい場合、今まではこの設定
■導入
Ver2.1.1 アルファ2以降を使っている場合はAmaRecVRServer.exeだけ上書きしてください。
アルファ版を使っていない場合はAmaRecVRServer.exeeとalphamapフォルダをコピーしてください。
初めて使う場合はAmaRecVRServer213フォルダ内のファイル全てをコピーしてください。
■その他
Ver200と上位互換です。アマレコVRアプリ Ver2.0.0からVer2.1.3まで利用できます。
ネットワーク（動画読み込みキャッシュ）に関する設定の変更はサーバープログラムの再起動が必要です。
いままでアプリ側に含めていたアルファマップに関するファイルをサーバー側に同梱しています。内容はアプリ Ver2.1.1アルファ2に同梱したものと同じです。
検索処理で アルファベットの大文字と小文字を区別しないようになりました。
検索処理で 半角スペースとアンダースコア、ハイフンを区別しないようになりました。
５．ダウンロード
・ アマレコVR Ver2.1.3 アルファ3
・ アマレコVRサーバー Ver2.13
オンラインヘルプ Ver2.0.0
新しいバージョン アマレコVR Ver2.1.7が公開されています。
アマレコVR アルファ3 進捗
アルファ3の公開準備を進めていましたが、Oculus Software v34のアップデートが11月4日あたりから始まり、v34にすると（開発者向けの？）パススルー機能が使えなくなっているようです。
私のことろではQuest1だけv34にアップデートされアマレコVRのパススルー機能が使えなくなっています。
v33でパススルー機能を使っている人はv34のアップデートを暫く待った方がいいかもしれません。
アマレコVRのアルファ3は1週間程度様子を見て進展が無いようなら、パススルー非対応（実験版のまま）な状態で公開します。
v34でアプリのパススルー機能を使えている人もいるのかな？
設定項目があるようなニュアンスの発言もあるし、パススルー機能を使えている人がいたらもう少し具体的な情報が欲しい。v34のアップデートも何段階かあって人によって違いが生じているのか、良く判らない状況です。
可能性を列挙すると
・v34でも開発者向けのパススルー機能が使える（不明、私のQuest1では使えていない）
・v34でパススルー機能が正式対応になったけど 対応するアプリはまだない（不明）
・v34でパススルー機能を使うには アプリのmanifestの変更が必要（不明）
・v34に対応した SDKのリリースを待つ必要がある（この可能性が高い）
私のことろではQuest1だけv34にアップデートされアマレコVRのパススルー機能が使えなくなっています。
v33でパススルー機能を使っている人はv34のアップデートを暫く待った方がいいかもしれません。
アマレコVRのアルファ3は1週間程度様子を見て進展が無いようなら、パススルー非対応（実験版のまま）な状態で公開します。
v34でアプリのパススルー機能を使えている人もいるのかな？
設定項目があるようなニュアンスの発言もあるし、パススルー機能を使えている人がいたらもう少し具体的な情報が欲しい。v34のアップデートも何段階かあって人によって違いが生じているのか、良く判らない状況です。
可能性を列挙すると
・v34でも開発者向けのパススルー機能が使える（不明、私のQuest1では使えていない）
・v34でパススルー機能が正式対応になったけど 対応するアプリはまだない（不明）
・v34でパススルー機能を使うには アプリのmanifestの変更が必要（不明）
・v34に対応した SDKのリリースを待つ必要がある（この可能性が高い）
アマレコVR Ver2.1.2 VRonVR 試作版 公開
2つのVR動画をアルファマップで合成するVRonVR機能の試作版です。
VRonVR機能がどんなものか体験してみて見てください。
※ アルファ2の導入が必要です。
先日の進捗を書いた時点でアルファ3のメインはクロマキー合成の予定でしたが、察しの通り 圧倒的なコンテンツ不足でほぼ出番はありません。そこで、アルファ2公開直前に思いついたのがVRonVRです。クロマキー合成もやるつもりですが アルファ3のメインはVRonVRにとって代わりました。
１．内容
新しくVR動画を再生するための3rdプレイヤーを追加しました。
メインプレイヤーと3rdプレイヤーの映像を（メイン画面設定にある）アルファマップAで合成します。
アルファマップAの白い部分がメインプレイヤー、黒い部分が3rdプレイヤーの映像になります。
その結果とパススルー映像がアルファマップBで合成されます。
メイン画面の右側のメニューへ 3rdプレイヤーに関する項目が追加されています。
コンソール画面へ 3rdプレイヤーに関する機能が追加されています。
ボタン機能へ 3rdプレイヤーに関する機能が追加されています。
ホイール機能
PCマウスのボタン機能が拡張されています。
２．注意事項
・全ての機能がちゃんと動くかどうか 確認は取れていません。
・アルファ2が使えていることが前提となります。アルファ2に含まれるアルファマップを導入してください。
・ アルファ1、アルファ2の記事も合わせて見てください。
・Oculus Quest 1でも動作はしますが、スペック的にQuest2でないと厳しいです。
Quest1は4K 60fpsの動画 1つで ほぼ限界に達します。
・新しいアプリとしてインストールされます。
・アマレコVRサーバーは更新なし。
・3rdプレイヤーはVRフォーマット等を手動で設定できません。ファイル名へタグを入れたり、画像サイズから自動判別できるように準備を徹底してください。
・サブプレイヤーと3rdプレイヤーは現状AVProで再生するため欠落フレームが生じます。
・サブプレイヤーとサムネイルプレイヤーを同時に使うことはできません。
自主的にサブプレイヤーを使わないか、または、カタログ機能を「リスト」にしてサムネイル機能を使わないようにしてください。
現在のアマレコVRサーバーは最大3ストリームまでしか対応していません。
次のように割り当てられます。
３．ダウンロード
・ アマレコVR Ver2.1.2 試作版
※ アルファ2の導入が必要です。
・ アマレコVRサーバー Ver2.00
※ アマレコVRサーバーは更新なし
新しいバージョン アマレコVR Ver2.1.7が公開されています。
VRonVR機能がどんなものか体験してみて見てください。
※ アルファ2の導入が必要です。
先日の進捗を書いた時点でアルファ3のメインはクロマキー合成の予定でしたが、察しの通り 圧倒的なコンテンツ不足でほぼ出番はありません。そこで、アルファ2公開直前に思いついたのがVRonVRです。クロマキー合成もやるつもりですが アルファ3のメインはVRonVRにとって代わりました。
１．内容
新しくVR動画を再生するための3rdプレイヤーを追加しました。
メインプレイヤーと3rdプレイヤーの映像を（メイン画面設定にある）アルファマップAで合成します。
アルファマップAの白い部分がメインプレイヤー、黒い部分が3rdプレイヤーの映像になります。
その結果とパススルー映像がアルファマップBで合成されます。
メイン画面の右側のメニューへ 3rdプレイヤーに関する項目が追加されています。
コンソール画面へ 3rdプレイヤーに関する機能が追加されています。
ボタン機能へ 3rdプレイヤーに関する機能が追加されています。
ホイール機能
PCマウスのボタン機能が拡張されています。
２．注意事項
・全ての機能がちゃんと動くかどうか 確認は取れていません。
・アルファ2が使えていることが前提となります。アルファ2に含まれるアルファマップを導入してください。
・ アルファ1、アルファ2の記事も合わせて見てください。
・Oculus Quest 1でも動作はしますが、スペック的にQuest2でないと厳しいです。
Quest1は4K 60fpsの動画 1つで ほぼ限界に達します。
・新しいアプリとしてインストールされます。
・アマレコVRサーバーは更新なし。
・3rdプレイヤーはVRフォーマット等を手動で設定できません。ファイル名へタグを入れたり、画像サイズから自動判別できるように準備を徹底してください。
・サブプレイヤーと3rdプレイヤーは現状AVProで再生するため欠落フレームが生じます。
・サブプレイヤーとサムネイルプレイヤーを同時に使うことはできません。
自主的にサブプレイヤーを使わないか、または、カタログ機能を「リスト」にしてサムネイル機能を使わないようにしてください。
現在のアマレコVRサーバーは最大3ストリームまでしか対応していません。
次のように割り当てられます。
ストリーム1：メインプレイヤー
ストリーム2：サブプレイヤー、サムネイルプレイヤー兼用
ストリーム3：3rdプレイヤー
３．ダウンロード
・ アマレコVR Ver2.1.2 試作版
※ アルファ2の導入が必要です。
・ アマレコVRサーバー Ver2.00
※ アマレコVRサーバーは更新なし
新しいバージョン アマレコVR Ver2.1.7が公開されています。
アマレコVR Ver2.1.1 パススルー実験版 アルファ2 公開
現在、開発者向けに公開されている Oculus Passthrough APIを利用したアマレコVR パススルー実験版の第2弾です。
アルファマップなどメイン画面設定の強化とサブ画面の強化
および、現実感を持たせるため全体をリアルスケールで再構成しました。
１．内容
【更新内容】
・メイン画面用のアルファマップが二枚構成になりました
・ブラックマスク、白黒、パススルーON/OFF、アルファ値ゲインを追加
・メイン画面のスケール設定を追加
・サブ画面用アルファマップを追加
・サブ画面設定へ 自動向き調整、メイン画面と連動、透明度、パススルーポータル機能を追加
・VRコントローラーで直接サブ画面の位置や向きを調整する機能を追加
・ノンスケールからリアルスケールへ変更、サブ画面までの距離を表示
・アルファマップを管理するalphamap.iniを追加
・ボタン機能の向き調整やチルトが使えなくなる不具合を修正（向き調整の前に、チルト操作を行うと発生する）
【その他】
・サブカメラ機能の映像ソースを選択する[CL]、[CR]は機能しません
・ボタン設定のVRコントローラーとBluetoothマウスの設定をサーバー側へ保存するように変更
・サブ画面のプリセットを廃止
【既知の不具合】
・サーバー側でサムネイルの自動作成をすると アプリが止まってしまうことがある
（サムネイルの作成が終わってから使うようにする）
【Ver2.1.0 アルファ1と同じ内容】
・ハンドトラッキングに関する機能は使えません
・パススルー機能は Oculus software v31以降でないと使えません
・Oculus Quest 1でも利用可能です
・アマレコVRアプリによりサムネイル画像を作成すると白っぽい画像になってしまいます
サムネイル画像の自動生成はサーバー側で行ってください
２．使い方
・Ver2.1.0 アルファ1の記事と合わせて見てください。
・アマレコVR自体の使い方は オンラインヘルプを見てください。
・Ver2.1.0 アルファ1とは異なるアプリとしてインストールされます。
・アマレコVRサーバーは更新なし
・Ver2.1.0 アルファ1からアルファマップの内容が更新されています。
再度、解凍してできる[alphamap]フォルダを丸ごと AmaRecVRServer.exe と同じフォルダへコピーしてください。
※ 自作のアルファマップを使っている場合は 上書きしないように工夫してください。
今回から[alphamap]フォルダ内の alphamap.iniを編集して自作のアルファマップを追加できます（rw.miMainPresetNum=5）。
旧アルファマップ Ver2.1.0 アルファ1
新アルファマップ Ver2.1.1 アルファ2
３．メイン画面設定
・メイン画面のアルファマップ
アルファマップAとアルファマップBの二枚構成になります。
従来通り1枚で理想的なアルファマップを用意して使うことも可能ですが、基本的なパターン2つを組み合わせる方が柔軟性があり簡単に多くのシチュエーションへ対応できます。
アルファマップAはメインスクリーンと連動して動く（チルト機能などの向き調整）のに対し、アルファマップBはメインスクリーンとは連動せずパススルー映像の位置に固定されます。
ですので、アルファマップAはVR動画の見たい部分、アルファマップBはパススルー映像の観たい部分をそれぞれ指定することになります。
・メインスクリーンを半透明にする（変更なし）
メイン画面へ透明度とアルファマップを適用します。
チェックボックスがOFFの場合 メインスクリーンは常に不透明となります。
ボタン機能でもON/OFFを切り替えることができます。
・選択▽
アルファマップを選択します。
アルファマップを無効にしたい場合は、各アルファマップのチェックボックスをOFFにしてください。
・白黒
パススルー映像と同様に メインスクリーンを白黒で表示します。
・パススルー
パススルー映像をON/OFFします。
・ブラックマスク
アルファマップAはブラックマスクとして使うことができます。
ブラックマスクにすると透明になる代わりに不透明な黒になります。
VR映像内の見たくない部分を隠すのが主な目的です。
・向きロック（変更なし）
ヘッドマウントディスプレイの向きに合わせて アルファマップを常に正面へ表示します。
・アルファ値ゲイン
アルファマップの値を調整します。
透明部分を半透明や不透明にしたりゲインをマイナスにすることで 白黒を反転します。
・メイン画面のスケール設定
VR映像を投影するスクリーンを大きくしたり、小さくします。
基本的にスケールを変更しても見た目はほとんど変わりません。
（スケールを大きくしてもカメラから遠ざかるため 表示される画像の大きさは変わらない）
違いが出るのはパススルー映像とVR映像の位置ズレです。スケールを大きくすると 遠くの映像の位置が合うようになります。
一方、VR映像に人物などが（近くに）映っている場合は スケールを50から100程度にすることで近くのパススルー映像とVRに映っている人物の位置が合うようになります。
ただし、メインスクリーンのスケールを小さくすると ポジショントラッキングの影響を大きく受けるため画像が歪みます。
また、パススルー映像と合成する際に遠くの方が大きくズレてしまいますので、遠くをアルファマップで隠したり、中心位置から動かないようにするなどの配慮が必要となります。
通常は240で使って下さい。
※ 240に設定すると半径2.4mの球へVR動画を投影します。
４．サブ画面設定
・自動向き調整
ONにすると各サブ画面がHMDの方へ向くようになります。
今までは常にONでした。今回からOFFにできるようになりました。
※ 今回からONの場合は各サブ画面の回転設定が無効になります。
・メイン画面と連動
メイン画面のチルト機能などをサブ画面へも適用します。
いままでは常にONでした。今回からOFFにできるようになりました。
・パススルーポータル
サブ画面の領域へ パススルー映像を表示します。
・アルファマップを適用する
サブ画面へアルファマップを適用し 映像端を半透明にします。
サイズで半透明にする幅を設定できます。
５．ボタン機能
・VRコントローラーで直接サブ画面の位置や回転を調整
ボタン機能に「[Quest]サブ画面 位置XYZ」、「[Quest]サブ画面 位置 向き」 を追加しました。動画視聴中（プレイ画面）、コンソール画面、サブ画面設定画面で使えます。
ボタンを押している間、サブ画面がVRコントローラーと同じ動き（位置の移動や 回転）をします。また、ボタンを押しながらスティックの上下で位置前後、左右でスケールを調整できます。
さらに調整中スティックや他のボタンを押すと、VRコントローラーの先にサブ画面が張り付きますので、パススルー映像に映っている部屋のテレビなどへ簡単にサブ画面を設置することができます。
※ スティックを使うため、この機能をスティックへ割り当てないでください。
※ サブ画面設定の[自動向き調整]がONの場合は 向きの調整はできません。
※ パススルー映像に合わせる場合は サブ画面設定の[自動向き調整]と［メイン画面と連動］をOFFにすることをお勧めします。これらは位置や向きが意図せず変わります。
６．ダウンロード
・ アマレコVR Ver2.1.1 アルファ2
・ アマレコVRサーバー Ver2.00
※ アマレコVRサーバーは更新なし
オンラインヘルプ Ver2.0.0
新しいバージョン アマレコVR Ver2.1.7が公開されています。
アルファマップなどメイン画面設定の強化とサブ画面の強化
および、現実感を持たせるため全体をリアルスケールで再構成しました。
アマレコVR パススルー実験版 第二弾をブログで公開しました。
— amaman (@amarectv) October 7, 2021
グリップを押しながらトリガーにより サブ画面の位置や向きの調整が可能です。
さらに、調整中にA,Bまたはスティックを押すとコントローラーの先にサブ画面が張り付きます。#OculusQuest #passthrough #VR #アマレコVR pic.twitter.com/E7aJ3nEwum
１．内容
【更新内容】
・メイン画面用のアルファマップが二枚構成になりました
・ブラックマスク、白黒、パススルーON/OFF、アルファ値ゲインを追加
・メイン画面のスケール設定を追加
・サブ画面用アルファマップを追加
・サブ画面設定へ 自動向き調整、メイン画面と連動、透明度、パススルーポータル機能を追加
・VRコントローラーで直接サブ画面の位置や向きを調整する機能を追加
・ノンスケールからリアルスケールへ変更、サブ画面までの距離を表示
・アルファマップを管理するalphamap.iniを追加
・ボタン機能の向き調整やチルトが使えなくなる不具合を修正（向き調整の前に、チルト操作を行うと発生する）
【その他】
・サブカメラ機能の映像ソースを選択する[CL]、[CR]は機能しません
・ボタン設定のVRコントローラーとBluetoothマウスの設定をサーバー側へ保存するように変更
・サブ画面のプリセットを廃止
【既知の不具合】
・サーバー側でサムネイルの自動作成をすると アプリが止まってしまうことがある
（サムネイルの作成が終わってから使うようにする）
【Ver2.1.0 アルファ1と同じ内容】
・ハンドトラッキングに関する機能は使えません
・パススルー機能は Oculus software v31以降でないと使えません
・Oculus Quest 1でも利用可能です
・アマレコVRアプリによりサムネイル画像を作成すると白っぽい画像になってしまいます
サムネイル画像の自動生成はサーバー側で行ってください
２．使い方
・Ver2.1.0 アルファ1の記事と合わせて見てください。
・アマレコVR自体の使い方は オンラインヘルプを見てください。
・Ver2.1.0 アルファ1とは異なるアプリとしてインストールされます。
・アマレコVRサーバーは更新なし
・Ver2.1.0 アルファ1からアルファマップの内容が更新されています。
再度、解凍してできる[alphamap]フォルダを丸ごと AmaRecVRServer.exe と同じフォルダへコピーしてください。
※ 自作のアルファマップを使っている場合は 上書きしないように工夫してください。
今回から[alphamap]フォルダ内の alphamap.iniを編集して自作のアルファマップを追加できます（rw.miMainPresetNum=5）。
旧アルファマップ Ver2.1.0 アルファ1
新アルファマップ Ver2.1.1 アルファ2
３．メイン画面設定
・メイン画面のアルファマップ
アルファマップAとアルファマップBの二枚構成になります。
従来通り1枚で理想的なアルファマップを用意して使うことも可能ですが、基本的なパターン2つを組み合わせる方が柔軟性があり簡単に多くのシチュエーションへ対応できます。
アルファマップAはメインスクリーンと連動して動く（チルト機能などの向き調整）のに対し、アルファマップBはメインスクリーンとは連動せずパススルー映像の位置に固定されます。
ですので、アルファマップAはVR動画の見たい部分、アルファマップBはパススルー映像の観たい部分をそれぞれ指定することになります。
・メインスクリーンを半透明にする（変更なし）
メイン画面へ透明度とアルファマップを適用します。
チェックボックスがOFFの場合 メインスクリーンは常に不透明となります。
ボタン機能でもON/OFFを切り替えることができます。
・選択▽
アルファマップを選択します。
アルファマップを無効にしたい場合は、各アルファマップのチェックボックスをOFFにしてください。
・白黒
パススルー映像と同様に メインスクリーンを白黒で表示します。
・パススルー
パススルー映像をON/OFFします。
・ブラックマスク
アルファマップAはブラックマスクとして使うことができます。
ブラックマスクにすると透明になる代わりに不透明な黒になります。
VR映像内の見たくない部分を隠すのが主な目的です。
・向きロック（変更なし）
ヘッドマウントディスプレイの向きに合わせて アルファマップを常に正面へ表示します。
・アルファ値ゲイン
アルファマップの値を調整します。
透明部分を半透明や不透明にしたりゲインをマイナスにすることで 白黒を反転します。
100：アルファマップの値がそのまま使われます
0：アルファマップの内容にかかわらず 真っ白になります
-100：アルファマップの値が反転（白と黒が反転）します
※ ゲインに合わせて オフセットが自動で設定されます。
ゲインが プラスの場合 offset = 100 - gain
ゲインが 0以下の場合 offset = 100
アルファマップ使用例
アルファマップの組み合わせと アルファ値ゲインの調整により次のようなことができます。
旧アルファマップ2は新アルファマップ1の「丸」のアルファ値ゲインを-100にして 白黒を反転することで代用できます。
旧アルファマップ3は「丸」と「グラデーション 片方」を組み合わせます。グラデーションの位置と向きを調整できます。
旧アルファマップ4は「丸」とアルファ値ゲインをマイナスに調整した「丸」を使います。丸の大きさや位置を調整できます。
・メイン画面のスケール設定
VR映像を投影するスクリーンを大きくしたり、小さくします。
基本的にスケールを変更しても見た目はほとんど変わりません。
（スケールを大きくしてもカメラから遠ざかるため 表示される画像の大きさは変わらない）
違いが出るのはパススルー映像とVR映像の位置ズレです。スケールを大きくすると 遠くの映像の位置が合うようになります。
一方、VR映像に人物などが（近くに）映っている場合は スケールを50から100程度にすることで近くのパススルー映像とVRに映っている人物の位置が合うようになります。
ただし、メインスクリーンのスケールを小さくすると ポジショントラッキングの影響を大きく受けるため画像が歪みます。
また、パススルー映像と合成する際に遠くの方が大きくズレてしまいますので、遠くをアルファマップで隠したり、中心位置から動かないようにするなどの配慮が必要となります。
通常は240で使って下さい。
※ 240に設定すると半径2.4mの球へVR動画を投影します。
４．サブ画面設定
・自動向き調整
ONにすると各サブ画面がHMDの方へ向くようになります。
今までは常にONでした。今回からOFFにできるようになりました。
※ 今回からONの場合は各サブ画面の回転設定が無効になります。
・メイン画面と連動
メイン画面のチルト機能などをサブ画面へも適用します。
いままでは常にONでした。今回からOFFにできるようになりました。
・パススルーポータル
サブ画面の領域へ パススルー映像を表示します。
・アルファマップを適用する
サブ画面へアルファマップを適用し 映像端を半透明にします。
サイズで半透明にする幅を設定できます。
５．ボタン機能
・VRコントローラーで直接サブ画面の位置や回転を調整
ボタン機能に「[Quest]サブ画面 位置XYZ」、「[Quest]サブ画面 位置 向き」 を追加しました。動画視聴中（プレイ画面）、コンソール画面、サブ画面設定画面で使えます。
ボタンを押している間、サブ画面がVRコントローラーと同じ動き（位置の移動や 回転）をします。また、ボタンを押しながらスティックの上下で位置前後、左右でスケールを調整できます。
さらに調整中スティックや他のボタンを押すと、VRコントローラーの先にサブ画面が張り付きますので、パススルー映像に映っている部屋のテレビなどへ簡単にサブ画面を設置することができます。
※ スティックを使うため、この機能をスティックへ割り当てないでください。
※ サブ画面設定の[自動向き調整]がONの場合は 向きの調整はできません。
※ パススルー映像に合わせる場合は サブ画面設定の[自動向き調整]と［メイン画面と連動］をOFFにすることをお勧めします。これらは位置や向きが意図せず変わります。
６．ダウンロード
・ アマレコVR Ver2.1.1 アルファ2
・ アマレコVRサーバー Ver2.00
※ アマレコVRサーバーは更新なし
オンラインヘルプ Ver2.0.0
新しいバージョン アマレコVR Ver2.1.7が公開されています。
アマレコVR パススルー実験版 進捗
アマレコVRのパススルー実験版は3段階での開発を予定しています。
◇アルファ1
公開済み(2021-09-03)
・パススルー機能
・メイン画面へのアルファマップ
◇アルファ2
あと1週間程度で公開予定
・メイン画面のアルファマップ強化 (二枚構成、ブラックマスクなど)
・サブ画面の強化 (アルファマップ、VRコーントローラーで直接空間へ設置など)
・ノンスケールからリアルスケールへ変更 (座標や距離表示、オブジェクトの大きさ、視差などパススルー映像に近いリアルなものになります)
◇アルファ3
11月上旬予定
・クロマキー合成へ対応
そのほか
現在のOculus Passthrough APIはOpenXR版のOVRPluginを使う必要があります。
そして OpenXR版 OVRPluginはハンドトラッキングをはじめいくつか未対応な状態です。
https://developer.oculus.com/documentation/unity/unity-openxr/?locale=ja_JP
ハンドトラッキングが使えれば パススルー映像 VR映像 さらにその上に自分の手（場合によっては腕まで）を表示することができ、もう一段上の体験ができると思われますので 優先的に対応したいところですが、Oculus側の進捗を待つことになると思われます。アルファ3に間に合うといいなと思っています。
◇アルファ1
公開済み(2021-09-03)
・パススルー機能
・メイン画面へのアルファマップ
◇アルファ2
あと1週間程度で公開予定
・メイン画面のアルファマップ強化 (二枚構成、ブラックマスクなど)
・サブ画面の強化 (アルファマップ、VRコーントローラーで直接空間へ設置など)
・ノンスケールからリアルスケールへ変更 (座標や距離表示、オブジェクトの大きさ、視差などパススルー映像に近いリアルなものになります)
◇アルファ3
11月上旬予定
・クロマキー合成へ対応
そのほか
現在のOculus Passthrough APIはOpenXR版のOVRPluginを使う必要があります。
そして OpenXR版 OVRPluginはハンドトラッキングをはじめいくつか未対応な状態です。
https://developer.oculus.com/documentation/unity/unity-openxr/?locale=ja_JP
ハンドトラッキングが使えれば パススルー映像 VR映像 さらにその上に自分の手（場合によっては腕まで）を表示することができ、もう一段上の体験ができると思われますので 優先的に対応したいところですが、Oculus側の進捗を待つことになると思われます。アルファ3に間に合うといいなと思っています。
アマレコVR Ver2.1.0 パススルー実験版 （アルファ版）
現在、開発者向けに公開されている Oculus Passthrough APIを利用したアマレコVRの実験版です。
パススルー機能による周囲の映像とVR動画の映像を合成した ミックスドリアリティ体験ができます。
１．インストール
アマレコVRオンラインヘルプのAPKファイル インストールの項を見てください。
２．準備
２．１．開発者向け機能を有効にする
現在 Oculus Passthrough APIは開発者向けですので、アプリケーションを実行する前にOculus QuestとPCをUSBケーブルで接続してからADBコマンドで開発者向け機能を有効にする必要があります。
※ Questを再起動すると 無効に戻ってしまうので、その都度ADBコマンドで有効にする必要があります。
２．２．アルファ版とベータ版の使い分け
アマレコVR Ver2.1.0 アルファ版は Ver2.0.0 ベータ版とは別のアプリとしてインストールされます。
そのためVer2.0.0の環境を崩すことなく実験することができます。
一方、アマレコVRサーバーの更新はありません Ver2.00を共通で利用します。
２．３．アルファマップ用のPNG画像をアマレコVRサーバーへコピーする
解凍してできる[alphamap]フォルダを丸ごと AmaRecVRServer.exe と同じフォルダへコピーしてください。
３．使い方
パススルーに関する機能は[メイン画面設定]に集約されています。
・メインスクリーンを半透明にする
メイン画面へ透明度とアルファマップを適用します。
チェックボックスがOFFの場合 メインスクリーンは常に不透明となります。
・アルファマップ
VR動画は視界の多くを覆うため パススルーの映像が見えなくなってしまいます。
そこでアルファマップにより VR動画を表示する部分と パススルー映像を表示する部分を指定します。
アルファマップの白い部分へVR動画、黒い部分へパススルー映像を表示するようになっています。
アルファマップは5パターンあり 大きさと 位置調整ができます。
また、アルファマップ用のPNGファイルは差し替えることができます。
[アルファマップ1]
中央部分にVR動画 周囲をパススルー映像にします。
[拡大]でVR動画を表示する領域を調整してください。
[アルファマップ2]
中央部分をパススルー映像 周囲をVR動画にします。
[拡大]でパススルー映像を表示する領域を調整してください。
[アルファマップ3]
中央部分にVR動画を表示し 上のほうを半透明 下のほうを不透明にします。
[拡大]でVR動画を表示する領域を調整してください。
また、[拡大 縦]をマイナスにすることで 上の方を不透明 下の方を半透明にできます。
[アルファマップ4]
上の方の一部を半透明にします。
[アルファマップ5]
天井や床をパススルー映像にします。
・向きロック
ヘッドマウントディスプレイの向きに合わせて アルファマップを常に正面へ表示します。
４．ボタン設定
パススルーに関する機能が追加されています。
また、従来からありますが、メイン画面設定を直接表示する[メイン画面設定を表示]をお勧めします。
[半透明にする On/Off]は本体のボリュームボタンへ割り当てることをお勧めします。
マウスのホイールへ割り当てることができる機能
５．その他
・ハンドトラッキングに関する機能は使えません。
・パススルー機能は Oculus software v31以降でないと使えません。
・Oculus Quest 1でも利用可能です。
・アマレコVR実行中にパススルー映像をON / OFFにすることはできません。
・設定画面のマウスボタン設定でホイール機能が選べない不具合を修正しました。
・アマレコVRアプリによりサムネイル画像を作成すると白っぽい画像になってしまいます。
サムネイル画像の自動生成はサーバー側で行ってください。
・アルファマップにも視差があります。
範囲を小さくしすぎると VR動画の視差と合わず、見づらくなりますので注意してください。
・位置合わせ
VR動画とパススルー画像の位置をぴったり合わせようとするときに「ちょっと遠い」、「ちょっと近い」場合は[位置Z]と[Stereo調整]で行います。Stereo調整で合わせることができるならStereo調整を優先してください。
６．ダウンロード
・ アマレコVR Ver2.1.0
・ アマレコVRサーバー Ver2.00
アマレコVRサーバーは更新なし
オンラインヘルプ Ver2.0.0
新しいバージョン アマレコVR Ver2.1.7が公開されています。
パススルー機能による周囲の映像とVR動画の映像を合成した ミックスドリアリティ体験ができます。
１．インストール
アマレコVRオンラインヘルプのAPKファイル インストールの項を見てください。
２．準備
２．１．開発者向け機能を有効にする
現在 Oculus Passthrough APIは開発者向けですので、アプリケーションを実行する前にOculus QuestとPCをUSBケーブルで接続してからADBコマンドで開発者向け機能を有効にする必要があります。
adb.exe shell setprop debug.oculus.experimentalEnabled 1
※ Questを再起動すると 無効に戻ってしまうので、その都度ADBコマンドで有効にする必要があります。
２．２．アルファ版とベータ版の使い分け
アマレコVR Ver2.1.0 アルファ版は Ver2.0.0 ベータ版とは別のアプリとしてインストールされます。
そのためVer2.0.0の環境を崩すことなく実験することができます。
一方、アマレコVRサーバーの更新はありません Ver2.00を共通で利用します。
２．３．アルファマップ用のPNG画像をアマレコVRサーバーへコピーする
解凍してできる[alphamap]フォルダを丸ごと AmaRecVRServer.exe と同じフォルダへコピーしてください。
３．使い方
パススルーに関する機能は[メイン画面設定]に集約されています。
・メインスクリーンを半透明にする
メイン画面へ透明度とアルファマップを適用します。
チェックボックスがOFFの場合 メインスクリーンは常に不透明となります。
・アルファマップ
VR動画は視界の多くを覆うため パススルーの映像が見えなくなってしまいます。
そこでアルファマップにより VR動画を表示する部分と パススルー映像を表示する部分を指定します。
アルファマップの白い部分へVR動画、黒い部分へパススルー映像を表示するようになっています。
アルファマップは5パターンあり 大きさと 位置調整ができます。
また、アルファマップ用のPNGファイルは差し替えることができます。
[アルファマップ1]
中央部分にVR動画 周囲をパススルー映像にします。
[拡大]でVR動画を表示する領域を調整してください。
[アルファマップ2]
中央部分をパススルー映像 周囲をVR動画にします。
[拡大]でパススルー映像を表示する領域を調整してください。
[アルファマップ3]
中央部分にVR動画を表示し 上のほうを半透明 下のほうを不透明にします。
[拡大]でVR動画を表示する領域を調整してください。
また、[拡大 縦]をマイナスにすることで 上の方を不透明 下の方を半透明にできます。
[アルファマップ4]
上の方の一部を半透明にします。
[アルファマップ5]
天井や床をパススルー映像にします。
・向きロック
ヘッドマウントディスプレイの向きに合わせて アルファマップを常に正面へ表示します。
４．ボタン設定
パススルーに関する機能が追加されています。
また、従来からありますが、メイン画面設定を直接表示する[メイン画面設定を表示]をお勧めします。
[半透明にする On/Off]は本体のボリュームボタンへ割り当てることをお勧めします。
マウスのホイールへ割り当てることができる機能
５．その他
・ハンドトラッキングに関する機能は使えません。
・パススルー機能は Oculus software v31以降でないと使えません。
・Oculus Quest 1でも利用可能です。
・アマレコVR実行中にパススルー映像をON / OFFにすることはできません。
・設定画面のマウスボタン設定でホイール機能が選べない不具合を修正しました。
・アマレコVRアプリによりサムネイル画像を作成すると白っぽい画像になってしまいます。
サムネイル画像の自動生成はサーバー側で行ってください。
・アルファマップにも視差があります。
範囲を小さくしすぎると VR動画の視差と合わず、見づらくなりますので注意してください。
・位置合わせ
VR動画とパススルー画像の位置をぴったり合わせようとするときに「ちょっと遠い」、「ちょっと近い」場合は[位置Z]と[Stereo調整]で行います。Stereo調整で合わせることができるならStereo調整を優先してください。
６．ダウンロード
・ アマレコVR Ver2.1.0
・ アマレコVRサーバー Ver2.00
アマレコVRサーバーは更新なし
オンラインヘルプ Ver2.0.0
新しいバージョン アマレコVR Ver2.1.7が公開されています。
