# VCam 仮想カメラを利用してアバターを表示する macOS 向けのアプリです。 Zoom 等でカメラとして仮想のアバターを表示できます。カメラを利用できない環境でリアクションを伝えたい時に便利です。 {% embed url="" %} {% embed url="" %} {% embed url="" %} # 初期設定 {% hint style="info" %} VCam は「アプリケーション」フォルダにインストールする必要があります。ご注意ください。 {% endhint %} 1. アプリを開きます。 2. マイクやネットワークの利用許諾が出た場合は許可します。これらの機能はアバターの操作や仮想カメラの動作に必須です。 3. プラグインのインストールのアラートが出た場合は、インストールします。 4. Zoom や OBS 等の仮想カメラを利用するアプリを開いて、アバターが表示されるか確認します。 表示されなかった場合は、[よくある質問](/other/faq)を参考にトラブルシューティングをしてください。 # モデルの読み込み ## VCam メニューの「ファイル」からモデルを読み込めます。現在はローカルにある [VRM ファイル](https://vrm.dev/) または [VRoid Hub](https://hub.vroid.com/) のモデルに対応しています。
モデルファイルをドラッグ&ドロップして、読み込むこともできます。 ローカルの VRM ファイルを読み込んだ場合は、アプリ再起動時に自動的にそのモデルを読み込みます。VRoid Hub のモデルは自動設定されないため、再設定してください。 ### FBX や MMD ファイルを読み込みたい Unity を使うと、多くのファイルを VCam で読込み可能な VRM 形式に変換できます。 方法は下記のドキュメントなどを確認してください。 {% embed url="" %} ## VCam2D メニューの「ファイル」もしくはドラッグアンドドロップで Live2D Cubism モデルを読み込めます。下記の構成になっているフォルダを選択してください。 ``` - モデルフォルダ - <モデル名>.moc3 - テクスチャフォルダ - テクスチャ画像1.png - その他のファイル (physics3.json, motions, expressions フォルダなど) ``` # モデルの仕様 (VCam2D) VCam2D では Live2D Cubism モデルを制御するために、以下の Live2D パラメータを利用します。 ## パラメータ一覧 ### 体の動き | パラメータ ID | 値の範囲 | 説明 | | --------------- | --------- | --------------- | | ParamBodyAngleX | -10 \~ 10 | 体の X 軸回転（前後の傾き） | | ParamBodyAngleY | -10 \~ 10 | 体の Y 軸回転（左右の向き） | | ParamBodyAngleZ | -10 \~ 10 | 体の Z 軸回転（左右の傾き） | ### 頭の動き | パラメータ ID | 値の範囲 | 説明 | | ----------- | --------- | ------------ | | ParamAngleX | -30 \~ 30 | 頭の X 軸回転（上下） | | ParamAngleY | -30 \~ 30 | 頭の Y 軸回転（左右） | | ParamAngleZ | -30 \~ 30 | 頭の Z 軸回転（傾き） | ### 目の動き | パラメータ ID | 値の範囲 | 説明 | | -------------- | ----------- | ---------------------------- | | ParamEyeLOpen | 0.0 \~ 1.0 | 左目の開き具合（0.0=閉じている、1.0=開いている） | | ParamEyeROpen | 0.0 \~ 1.0 | 右目の開き具合（0.0=閉じている、1.0=開いている） | | ParamEyeBallX | -1.0 \~ 1.0 | 視線の X 方向（左右） | | ParamEyeBallY | -1.0 \~ 1.0 | 視線の Y 方向（上下） | | ParamEyeLSmile | 0.0 \~ 1.0 | 左目の笑顔表現 | | ParamEyeRSmile | 0.0 \~ 1.0 | 右目の笑顔表現 | ### 口の動き | パラメータ ID | フォールバック ID | 値の範囲 | 説明 | | --------------- | ---------- | ---------- | -------- | | ParamMouthOpenY | ParamA | 0.0 \~ 1.0 | 口の開き具合 | | ParamA | - | 0.0 \~ 1.0 | 「あ」の母音形状 | | ParamI | - | 0.0 \~ 1.0 | 「い」の母音形状 | | ParamU | - | 0.0 \~ 1.0 | 「う」の母音形状 | | ParamE | - | 0.0 \~ 1.0 | 「え」の母音形状 | | ParamO | - | 0.0 \~ 1.0 | 「お」の母音形状 | ### その他の表情 | パラメータ ID | 値の範囲 | 説明 | | ----------- | ---------- | ------- | | ParamBreath | 0.0 \~ 1.0 | 呼吸の動き | | ParamCheek | 0.0 \~ 1.0 | 頬の赤らみ表現 | ## その他 Live2D Cubism の標準パラメータについては、公式ドキュメントを参照してください。 * [Live2D Cubism 標準パラメータリスト](https://docs.live2d.com/cubism-editor-manual/standard-parameter-list/) また、読み込めないモデルや正しく動作しないモデルがある場合は、お問い合わせよりご連絡ください。 # 一般設定 ⚙️ボタンをクリックし、「一般」タブで様々な設定ができます。 ### 待機モーションをランダム再生する ランダムな待機モーションを再生します。トラッキングを無効にして利用したいときにおすすめです。 ### モデルのメッシュを最適化する アバターのメッシュの一部を自動的に結合し、アバターの描画に掛かる負荷を軽減します。 通常はONにしておくことをおすすめしますが、アバターの表示に問題が起きた場合はOFFにしてください。 ### VRM0.x系のアバターを1.0系に自動変換する VRM0.x系のアバターをVRM1.0系に自動変換します。 **将来的にこの設定が常に有効になります。** この設定がONでもアバターが読み込めるような0.xのモデルを作成するか、1.0系のモデルを用意することを推奨します。 すぐにモデルの調整ができない場合はOFFにして利用してください。 ### 仮想カメラの画面を左右反転する 仮想カメラの画面が左右反転している場合にONにしてください。 ### macOSのメニューバーに追加する VCamを閉じても、Macのメニューバーに追加されたままになります。 Macのメニューバーに追加すると下記のメリットがあります。 * VCamを毎回起動しなくても仮想カメラを使うアプリ (OBSやZoomなど) を立ち上げるだけで、自動的にWebカメラなどを起動し、アバターを表示できる * 仮想カメラを使うアプリを閉じると自動的にWebカメラなどの利用やトラッキングが停止する メニューバーに追加せず、そのままアプリを終了したい場合はOFFにしてください。 ### 言語 現在は日本語と英語に対応しています。 表示言語は macOS のアプリごとの言語設定に従います。変更したい場合は「macOSの言語設定を開く」をクリックして、システム設定でVCamの言語を選択してください。 # トラッキング設定 をクリックするか、⌘+, を入力すると設定画面が開きます。 「トラッキング」タブが主なトラッキング設定です。
## トラッキング方法を変更する
各部位のトラッキング方法は最初は「デフォルト」になっています。これはMacのカメラでトラッキングすることを指します。 他にも外部アプリと連携してトラッキングさせたり、トラッキングをOFFにすることもできます。 ## 使用するデバイスの変更
外部のWebカメラやマイクなどを使用したい場合はここで変更できます。 リップシンク (口パク) の方法をカメラからマイクに変更することもできます。 また、カメラの場合は母音を推定して口の形に反映させることもできます。 ## 目をトラッキングする カメラを利用して、目を上下左右に動かせるようにします。 ## トラッキングのクオリティを上げる ### カメラとの位置関係 Webカメラの中央に顔が映るようにしてください。顔とカメラの距離感は以下の画像のような比率がおすすめです。QuickTimer Playerなどでカメラの映りを確認してみてください。 ![](https://user-images.githubusercontent.com/8188636/173237323-3f70184c-4efb-438d-8234-aa7fc9210e5d.png) ### カメラFPSの変更 カメラFPSを大きな値にするとなめらかにアバターが動きます。 この数値を大きくするとAIによる計算の負荷が大きくなるため、マシンスペックに合わせて変更してください。 おすすめは最大です。 # 仮想カメラ設定 VCam には仮想カメラと呼ばれるカメラ機能があります。 これを利用することで、Zoom や Google Meet などのビデオ会議アプリなどでも、VCam をカメラとして認識させることができます。 ## 仮想カメラの設定 VCam の設定画面の「仮想カメラ」で動作状況の確認や仮想カメラのインストールやアンインストールができます。 ![image](https://github.com/vcamapp/app/assets/8188636/a39c5c68-7215-42a4-bcf4-8a2f97cfb198) インストールやアンインストール後は Mac の設定の「一般」→「ログイン項目と拡張機能」→「カメラ機能拡張」の i マーク →VCam.app の CameraExtension を有効にする必要があります。
{% hint style="info" %} 現在の macOS ではプラグインのインストールやアンインストール時に Mac の再起動が必要になる場合があります。正常に動作しない場合などは Mac を再起動してください。 また、VCam が「アプリケーション」フォルダにインストールされている必要があります。 {% endhint %} ## 仮想カメラの使い方 カメラを利用するアプリのカメラ一覧に「VCam - CameraExtension \[番号]」が表示されます。 ![zoom](https://github.com/vcamapp/docs/assets/8188636/288b4213-3320-4b36-b58a-ecc19c83eef3) 「VCam - CameraExtension」を選ぶと、VCam の映像を表示できます。 ## 仮想カメラの更新 VCam のバージョンアップに伴い、仮想カメラの更新が必要になる場合があります。その場合は、VCam の設定画面の「仮想カメラ」で「再インストール」をクリックしてください。 再インストール後は、VCam アプリを再起動してください。 現在の最新バージョンは「`VCam - CameraExtension [3]`」です。 ## VCam と VCam2D 併用時の注意点 VCam と VCam2D は同じ名前の仮想カメラを使用します。両方をインストールした後にどちらかをアンインストールすると、仮想カメラが正常に動作しなくなる場合があります。その場合は、利用しているどちらかの VCam アプリを再インストールしてください。 # OBS と連携する Mac版のOBSと連携して、VCamの映像をOBSで表示することができます。
## VCam OBS Pluginを使う (おすすめ) この方法は他の方法に比べて負荷を軽減できます。 {% hint style="info" %} このプラグインを利用するためには、仮想カメラが有効になっている必要があります。まだ有効にしていない場合は、[仮想カメラを有効にする](https://docs.vcamapp.com/virtual-camera/virtualcamera)をご覧ください。 {% endhint %} ### インストール 下記から最新版の .pkg ファイルをダウンロードし、ファイルを開いてインストールします。\ インストール後、OBS Studioは再起動してください。 {% embed url="" %} ### 使い方 1. OBS Studioのソースの「+ボタン」をクリックし、「VCam」を選択して、ソースに追加します。 2. VCamアプリを開きます。 3. OBS StudioにVCamの映像が映ります。 ### クロマキー無しで背景を透明にする VCamの背景選択から背景色を選択します。
そして、不透明度を0%にすると、OBS上の背景が透明になります。
## 映像デバイスとしてVCamを利用する 1. ソースの追加ボタンから「映像キャプチャデバイス」を選択し、新規作成します。
2. デバイスから「VCam - CameraExtension \[数字]」を選択します。
※この時に事前にVCamを開いていれば、プレビューが表示されます。選択後にVCamを起動した場合は、デバイスのリストから別のデバイスを選んだ後にVCamを選び直すことでプレビューできます。 3. ソースをCtrl+クリックし、メニューから「フィルタ」を選択します。 ![image](https://user-images.githubusercontent.com/8188636/154321674-cdf851d8-e375-4193-9481-f8f55ce91b64.png) 4. エフェクトフィルタの追加ボタンをクリックし、「クロマキー」を選択します。 ![image](https://user-images.githubusercontent.com/8188636/154321774-076ca337-bb98-4911-bb56-359b3c07ee54.png) 5. VCam側の背景色に合わせて、色キーを設定すると背景色を消すことができます。 ![image](https://user-images.githubusercontent.com/8188636/154322044-acf1ea4a-37b7-4b88-ae27-bcaa61a405e8.png) 6. (ウィンドウサイズによって余白が出ている場合は) エフェクトフィルタに「クロップ/パッド」を追加することで黒帯などを消すことができます。 ![image](https://user-images.githubusercontent.com/8188636/154323204-aa42c68c-3749-49b5-9902-00c2346e953b.png) これで自由自在にアバターとゲームの映像などを合成できるようになりました。\ VCamはアプリを最小化していても多くの機能は動作をするため、操作ウィンドウが不要な方は最小化してみてください。 # mocopi と連携する (VCam) Sonyのモーションキャプチャー「mocopi」との連携をサポートしています。 {% embed url="" %} ## 連携方法 1. mocopiのアプリを起動して、モーションキャプチャーを開始します。 手順はmocopiアプリに従ってください。 ![mocopi](https://github.com/vcamapp/docs/assets/8188636/a8ef381d-5af2-4bd5-8fa8-a919c74e09c8) 2. 右上のメニューから「設定」→「外部サービスとの接続設定」を選びます。 ![](https://github.com/vcamapp/docs/assets/8188636/e305540d-4134-4b62-9e8f-f6730521037e) ![](/files/uDkuL3tqbgvvkqWAuV5L) 3. VCamアプリを開いて、 ⚙️ ボタンをクリックし、「連携」タブからmocopiを有効にします。 ![VCam](https://github.com/vcamapp/docs/assets/8188636/4ef7a7b3-f2e5-4664-ab36-8d4fa753bb44) 4. mocopiアプリの「外部サービスとの接続設定」で送信先を「配信支援アプリ」を選びます。次に、3のVCamの設定画面に表示されているInfoのIPアドレスを「IPアドレス」に指定して、OKを押します。 (ポート設定や送信フォーマットは画像の通り、そのままにしてください) ![mocopi](/files/nDIzbtLTj3NMJ4erEHTp) もし、IPアドレスが表示されない場合は、下記のサイトなどを参考にIPアドレスを確認してください。\ 5. mocopiでモーションキャプチャーを開始 (画面下中央のボタン) すると、VCamに反映されます 🎉 ## Tips / 活用テクニック mocopiアプリはバックグラウンドでも動きます。そのため、[VCamMocap](https://tattn.fanbox.cc/posts/5134895)やiFacialMocapも同時に接続できます。 ## トラブルシューティング ### VCamでアバターをクリックして選択できない mocopiのトラッキングでの表示位置がズレている可能性があります。下記のボタンをタップして位置を修正してください。 ![mocopi](https://github.com/vcamapp/docs/assets/8188636/ac6f636c-f31f-4d24-9280-bf50d1feee66) ### mocopiアプリではトラッキング開始しているのにVCamに反映されない iPhoneとMacが同じWiFiに繋がっているか確認してください。またセキュリティソフトなどでポート「12351」が塞がっていないか確認してください。 [BVH Sender](https://www.sony.net/Products/mocopi-dev/jp/downloads/DownloadInfo.html#BVH_Sender)を使うとmocopiなしで動作確認ができます (IPアドレスは127.0.0.1を指定してください)。このアプリのモーションがVCamに反映できる場合はネットワーク周りの設定に問題がある可能性が高いです。再度ご確認ください。 ### VCam側の動きがmocopiアプリ側と比べて1秒ほど遅延している 一度mocopiアプリで接続を解除し、再接続をお試しください。 ### mocopiとの連携を解除したい 設定画面の連携タブからmocopiを有効にするチェックを外します。その後、トラッキングタブでトラッキング方法を選択します。もし「手」が選択できないときはmocopi連携のチェックが外れているか確認してください。 ![VCam](https://github.com/vcamapp/docs/assets/8188636/fc69e9c1-f8a3-4327-a5a2-6e067680f9c7) ### mocopiで前後に動けない 現在は左右の動きだけ反映される仕様にしています。前後の動きは将来のアップデートをお待ち下さい。 # iPhone トラッキングアプリと連携する iPhoneのTrueDepthカメラ(FaceID)を使った高精度なフェイストラッキングを行うアプリとの連携ができます。 現在は下記のアプリに対応しています。 * [VCamMocap](https://tattn.fanbox.cc/posts/5134895) * [iFacialMocap](https://www.ifacialmocap.com/home/japanese/) ## VCamMocapとの連携方法 下記ページをご覧ください。 ## iFacialMocapとの連携方法 1. iFacalMocapアプリを開いてiPhoneのIPアドレスを確認します。 ![iFacialMocap](https://github.com/vcamapp/docs/assets/8188636/7d8dd8cd-cb77-41e9-973f-bc95a6d5d9fb) 2. VCamの「連携」メニューを開いて、IPアドレスを入力し、「接続」ボタンを押すと連携されます。\ ![image](https://github.com/vcamapp/docs/assets/8188636/67a60b8b-42e2-4e7c-b6a9-1f7ceb1519e4) 3. 「トラッキング」メニューで顔のトラッキングを「iFacialMocap」に変更するとトラッキング結果がVCamに反映されます。\ ![image](https://github.com/vcamapp/docs/assets/8188636/b844ec96-5111-4670-a1d1-3f8e8cd95988) # よくある質問 ※ Zoom等のクライアントをカメラアプリと表記しています。 ## **アプリが動かない** 本アプリは現在β版です。動作が不安定な場合があります。\ 不具合は開発者に下記の情報をセットで報告していただけると修正できる場合があります。 ``` (例) macOSバージョン: 26.0 チップ: M4 Pro メモリ: 24GB 利用しているカメラアプリ: Zoom 不具合内容: 最初にこのアプリを起動し、その後Zoomを起動したところ、最初はアバターが表示されましたが、1時間ほどすると画面が映らなくなりました。 ``` また、既存の不具合の回避方法は[不具合情報](/other/issue)にありますので、ご確認ください。 ## **動作が重い** 日々パフォーマンス改善に向けて調整していますので、最新版アプリをご利用ください。\ それでも重たい場合は、設定画面で下記をお試しください。 * 「レンダリング」タブで「描画品質」を下げる * 「レンダリング」タブで「画面解像度」を下げる (Web会議では 1280x720 がおすすめです) * 「レンダリング」タブで「FPS (画面の更新頻度)」を下げる * 「トラッキング」タブで「カメラFPS (トラッキングの更新頻度)」を下げる * 使っていないトラッキング (手や指など) を「無効」にする * [iPhoneトラッキングアプリ](/integration/iostrackingapp)と連携してトラッキング処理をiPhoneに任せる ## **カメラアプリに画面が表示されない** 以下を試して、改善するかをご確認ください。 * カメラアプリのカメラをOffにした後、Onにしてください。これによって再接続が行われ、改善する場合があります。 * カメラアプリのカメラを実際のカメラや別の仮想カメラなどに切り替えた後、VCamに戻してください。これによって再接続が行われ、改善する場合があります。 * カメラアプリやVCamを再起動してください。 * 仮想カメラを再インストールしてください。 [参考](/virtual-camera/virtualcamera) ## **カメラアプリでカメラをOnにできない** 本アプリの仮想カメラプラグインがクラッシュしています。カメラアプリを再起動してプラグインを再読込してください。 *Console.appを開いて、クラッシュレポートを選択し、Zoomなら「caphost」で検索して表示されるレポートを開発者に報告していただけると嬉しいです* ## **手がうまく動かせない** 実際の人の手の位置ではなく、カメラに映っている手の位置を基準にアバターに反映しています。\ これはMacBookなどで手を真上に挙げた時などに、カメラ外に行ってしまう問題を防ぐためです。QuickTime Playerを開いて、「新規ムービー収録」をクリックしてカメラの映りを確認してみてください。\ 詳しくは下記の動画を見てください。\ ## **アバターがどこかに行った** アバターを選択して左矢印のボタンを押すと初期位置に戻ります。 ![](https://user-images.githubusercontent.com/8188636/171683049-7c58e297-f3ed-46de-bb61-e38c056a2867.png) ## **YouTube等の配信で使いたいけど使ってもいい？** 利用可能です。「#VCam」のハッシュタグにて配信をシェアしていただけると嬉しいです！ ## **透かし (ウォーターマーク) を見えないようにして利用してもいい？** 透かしのあるアプリをご利用の場合は必ず透かしが視認できる状態でご利用ください。\ 現在ご支援いただいている方には透かしのないアプリを配布しています。そのような利用にはこちらをご検討ください。 [透かしのないアプリはこちら](https://vcamapp.com/download) ## **macOS以外で使いたい！** macOS版の開発が落ち着き次第、Windows版などの開発も検討しています。一人で開発しているため、お時間かかりますが、応援お願いします :pray: # 不具合情報 ### 不具合情報 下記に記載のない不具合を発見した方は、[VCam](https://vcamapp.com/)の下部の「お問い合わせ」から連絡していただけると嬉しいです。 [よくある質問](/other/faq) ### 現行版 (VCam 0.13 以降 / VCam2D) * VCam起動中にAirPodsなどのマイクを接続するとリップシンクが動かなくなることがある * 【対処方法】 マイク接続後にリップシンクの方式を再選択してください。もしくは、VCamを再起動してください。 * 感情 (笑顔など) の推定の精度が低い * 【対処方法】 意図しない表情になる場合は「実験的な機能」タブの「マイクまたはカメラで感情を推定する」をOFFにして、表情ボタンやショートカットで表情を切り替えてください。 * 表情ボタンと瞬きや口パクを組み合わせると表情が崩れる (VCam) * 【対処方法】 VRMファイルのブレンドシェイプ作成時にAとBlinkを他の表情と組み合わせても崩れないようにしてください。 * Zoomで画面がちらつく * 【対処方法】 「レンダリング」タブのFPSや「トラッキング」タブのカメラFPSを下げてください。 (トラッキングや画面の更新処理が間に合っていない可能性があります)
過去の不具合 ### バージョン 0.2.1 * Mac mini等の標準のカメラが搭載されていないデバイスでアプリがクラッシュする ### バージョン 0.1.2 〜 0.2.0 * ウィンドウをリサイズすると画面が映らなくなる * 【対処方法】 何度かリサイズしていると画面が表示されます。修正まではその画面サイズでご利用ください。 * アプリを起動するとアバターの位置が画面外になることがある * 【対処方法】 初期位置に移動ボタンを押してください * たまにカメラトラッキングが動かない * 【対処方法】 設定タブでカメラの使用をOFFにした後、ONに戻してください ### バージョン 0.1.0 〜 0.1.1 * アプリがまれに固まる、アプリ終了時にクラッシュする * Google Meetなどのブラウザの機能で仮想カメラを呼び出すと映像が固まる場合がある * 【対処方法】 OBSの仮想カメラなどを経由して本アプリの映像を送るようにしてください * 初回起動時にカメラトラッキングが動かない * 【対処方法】 アプリを再起動してください
# VCam を応援する VCamの応援ありがとうございます！一つ一つの応援が開発のモチベーションになっています。本当にありがとうございます！ ぜひ、SNS等で「#VCam」のハッシュタグをつけて、使っている様子を共有していただけるととても嬉しいです！ もっと積極的な応援をしてくださる方は、以下からスポンサードが可能です。 * [pixivFANBOX](https://tattn.fanbox.cc/plans) * [GitHub Sponsors](https://github.com/sponsors/tattn) * [Patreon](https://www.patreon.com/tattn) * [PayPal](https://www.paypal.com/paypalme/tattn) # VCam VCam is an application for macOS that displays avatars using a virtual camera. You can display a virtual avatar as a camera in Zoom and similar apps. It's handy when you want to convey reactions in environments where you can't use a camera. [VCam Official Website](https://vcamapp.com/en) {% embed url="" %} {% embed url="" %} # Initial Setup {% hint style="info" %} VCam must be installed in the "Applications" folder. {% endhint %} 1. Open the app. 2. If prompted for microphone or network permissions, grant them. These functions are essential for avatar control and the operation of the virtual camera. 3. If alerted to install a plugin, proceed with the installation of the plugin. 4. Open an app that uses a virtual camera, like Zoom or OBS, and check if the avatar is displayed. If it doesn't display the avatar, please refer to the [FAQ](/en/other/faq) for troubleshooting. # Loading Model ## VCam From the menu, select "File" to load a model. Currently, it supports [VRM files](https://vrm.dev/) available locally or models from [VRoid Hub](https://hub.vroid.com/).
You can also drag & drop the model file to load it. If you load a local VRM file, the app will automatically load that model when you restart it. However VRoid Hub models are not set automatically, so please reconfigure them manually. ### Want to Load FBX or MMD Files? By using Unity, you can convert many files into the VRM format, which can be loaded by VCam. Please check the following documentation for how to do it: {% embed url="" %} ## VCam2D You can load Live2D Cubism models from the "File" menu or by drag and drop. Please select a folder with the following structure: ``` - Model folder - .moc3 - Texture folder - image1.png - Other files (physics3.json, motions, expressions folders, etc.) ``` # Model Specification (VCam2D) VCam2D controls Live2D Cubism models using the following Live2D parameters. ## Parameter List ### Body Movement | Parameter ID | Value Range | Description | | --------------- | ----------- | ---------------------------- | | ParamBodyAngleX | -10 \~ 10 | Body X-axis rotation (pitch) | | ParamBodyAngleY | -10 \~ 10 | Body Y-axis rotation (yaw) | | ParamBodyAngleZ | -10 \~ 10 | Body Z-axis rotation (roll) | ### Head Movement | Parameter ID | Value Range | Description | | ------------ | ----------- | ---------------------------- | | ParamAngleX | -30 \~ 30 | Head X-axis rotation (pitch) | | ParamAngleY | -30 \~ 30 | Head Y-axis rotation (yaw) | | ParamAngleZ | -30 \~ 30 | Head Z-axis rotation (roll) | ### Eye Movement | Parameter ID | Value Range | Description | | -------------- | ----------- | ----------------------------------------- | | ParamEyeLOpen | 0.0 \~ 1.0 | Left eye openness (0.0=closed, 1.0=open) | | ParamEyeROpen | 0.0 \~ 1.0 | Right eye openness (0.0=closed, 1.0=open) | | ParamEyeBallX | -1.0 \~ 1.0 | Gaze X direction (left-right) | | ParamEyeBallY | -1.0 \~ 1.0 | Gaze Y direction (up-down) | | ParamEyeLSmile | 0.0 \~ 1.0 | Left eye smile expression | | ParamEyeRSmile | 0.0 \~ 1.0 | Right eye smile expression | ### Mouth Movement | Parameter ID | Fallback ID | Value Range | Description | | --------------- | ----------- | ----------- | --------------- | | ParamMouthOpenY | ParamA | 0.0 \~ 1.0 | Mouth openness | | ParamA | - | 0.0 \~ 1.0 | Vowel shape "A" | | ParamI | - | 0.0 \~ 1.0 | Vowel shape "I" | | ParamU | - | 0.0 \~ 1.0 | Vowel shape "U" | | ParamE | - | 0.0 \~ 1.0 | Vowel shape "E" | | ParamO | - | 0.0 \~ 1.0 | Vowel shape "O" | ### Other Expressions | Parameter ID | Value Range | Description | | ------------ | ----------- | ---------------------- | | ParamBreath | 0.0 \~ 1.0 | Breathing motion | | ParamCheek | 0.0 \~ 1.0 | Cheek blush expression | ## Additional Information For more information about Live2D Cubism standard parameters, please refer to the official documentation: * [Live2D Cubism Standard Parameter List](https://docs.live2d.com/cubism-editor-manual/standard-parameter-list/) If you encounter models that cannot be loaded or do not work correctly, please contact us through the inquiry form. # General Click on the button "⚙️" and make various settings under the "General" tab. ### Play idle motions It plays a random waiting motion. Recommended when you want to use it with tracking disabled. ### Optimize meshes It automatically combines parts of the avatar's mesh, reducing the load on rendering the avatar. It's usually recommended to keep this ON. However, if there are issues with the avatar display, please turn it OFF. ### Convert VRM 0.x to VRM 1.x It automatically converts VRM0.x series avatars to VRM1.0 series. **This setting will always be enabled in the future.** Even with this setting ON, we recommend creating a model that can load in the 0.x series or preparing a 1.0 series model. If you can't adjust the model immediately, please turn it OFF. ### Flip screen of the virtual camera Turn this ON if the virtual camera screen appears flipped horizontally. ### Add icon in macOS menu bar Even when VCam is closed, it remains added to the Mac menu bar. There are advantages to adding it to the Mac menu bar: * You don't have to start VCam every time; just launching an app that uses a virtual camera (like OBS or Zoom) will automatically activate the webcam and display the avatar. * When you close the app using the virtual camera, the webcam and tracking will stop automatically. If you want to exit the app without adding it to the menu bar, please turn it OFF. ### Language Currently, it supports Japanese and English. The display language follows the per-app language setting of macOS. To change it, click "Open the language settings of macOS" and select the language for VCam in System Settings. # Tracking Settings Click on the icon or press ⌘+, to open the settings menu. The "Tracking" tab contains the primary tracking settings.
## Changing Tracking Method
Each body part's tracking method is initially set to "Default". This refers to tracking using the Mac's built-in camera. You can also integrate with external apps for tracking or turn the tracking OFF. ## Changing the Device in Use
If you want to use an external webcam or microphone, you can change it here. You can also switch the lip-sync method from the camera to the microphone. For cameras, you can also estimate vowel sounds and reflect them in the mouth shape. ## Eye Tracking Utilize the camera to allow eye movement up, down, left, and right. ## Improve Tracking Quality ### Position Relative to the Camera Ensure your face is centered in the webcam's view. The recommended distance ratio between your face and the camera is illustrated in the image below. You can check your camera's view using applications like QuickTimer Player. ![](https://user-images.githubusercontent.com/8188636/173237323-3f70184c-4efb-438d-8234-aa7fc9210e5d.png) ### Changing Camera FPS Increasing the Camera FPS will make the avatar's movement smoother. Raising this value will increase the computational load due to AI, so adjust it according to your machine's specifications. The maximum setting is recommended. # Virtual Camera Settings VCam has a camera function called a virtual camera. By using this, you can get video conferencing apps such as Zoom and Google Meet to recognize VCam as a camera. ## Set up the Virtual Camera In the "Virtual Camera" settings of VCam, you can check the status and install or uninstall the virtual camera. ![image](https://github.com/vcamapp/app/assets/8188636/a39c5c68-7215-42a4-bcf4-8a2f97cfb198) After installation or uninstallation, you need to enable the CameraExtension in macOS's Settings under General > Login Items & Extensions > Camera Extensions' info icon > VCam.app.
{% hint style="info" %} For the current macOS, there may be times when you need to restart your Mac after installing or uninstalling plugins. If it's not working properly, please restart your Mac. And, VCam must be installed in the "Applications" folder. {% endhint %} ## How to Use the Virtual Camera In the camera list of the application that uses a camera, "VCam - CameraExtension \[Number]" will be displayed. ![zoom](https://github.com/vcamapp/docs/assets/8188636/288b4213-3320-4b36-b58a-ecc19c83eef3) When you select "VCam - CameraExtension", the virtual camera displays the VCam's screen. ## Updating the Virtual Camera When VCam is updated, you may need to update the virtual camera. In that case, click "Reinstall" in the "Virtual Camera" section of VCam's settings screen. After reinstalling, restart the VCam app. The current latest version is "`VCam - CameraExtension [3]`". ## Notes When Using VCam and VCam2D Together VCam and VCam2D use a virtual camera with the same name. If you uninstall either VCam or VCam2D after installing both, the virtual camera may not function properly. In such cases, please reinstall the VCam app you are using. # Integrate with OBS You can display VCam video on OBS by integrating with the Mac version of OBS. ![OBS Studio](https://github.com/vcamapp/docs/assets/8188636/d76b22c8-84de-4b10-af07-cc757519b1cf) ## Using the VCam OBS Plugin (Recommended) This method reduces the load compared to other methods. {% hint style="info" %} To use this plugin, the virtual camera must be enabled. If you haven't enabled it yet, please see [Enable Virtual Camera](https://docs.vcamapp.com/en/virtual-camera/virtualcamera). {% endhint %} ### Installation Download the latest .pkg file from the link below and open the file to install.\ After installing, please restart OBS Studio. {% embed url="" %} ### How to use 1. Click on the "+" button under OBS Studio's sources, select "VCam" and add it to the sources. 2. Open the VCam app. 3. VCam's video will now appear in OBS Studio. ### Making the background transparent without chroma key Choose a background color from VCam's background selection.
By setting the opacity to 0%, the background on OBS becomes transparent.
## Using VCam as a Video Device 1. From the "Add Source" button, select "Video Capture Device" and create a new one.
2. From devices, select "VCam - CameraExtension \[number]".
* If you have VCam opened in advance, a preview will be displayed. If you start VCam after selecting, choose another device from the device list and reselect VCam to preview. 3. Ctrl+click on the source, and select "Filters" from the menu. ![image](https://user-images.githubusercontent.com/8188636/154321674-cdf851d8-e375-4193-9481-f8f55ce91b64.png) 4. Click on the "Add Effect Filter" button and select "Chroma Key". ![image](https://user-images.githubusercontent.com/8188636/154321774-076ca337-bb98-4911-bb56-359b3c07ee54.png) 5. Match the color key to VCam's background color to remove the background. ![image](https://user-images.githubusercontent.com/8188636/154322044-acf1ea4a-37b7-4b88-ae27-bcaa61a405e8.png) 6. If there are black bars (depending on the window size), you can remove them by adding "Crop/Pad" to the effect filters. ![image](https://user-images.githubusercontent.com/8188636/154323204-aa42c68c-3749-49b5-9902-00c2346e953b.png) You can now freely combine avatars and game footage.\ Even if you minimize the VCam app, many features will still work. If you don't need the operation window, try minimizing it. # Integrate with mocopi (VCam) VCam supports integration with Sony's motion capture software, "mocopi". {% embed url="" %} ## How to Integrate 1. Launch the mocopi app and start motion capture. Follow the instructions provided in the mocopi app. ![image](https://github.com/vcamapp/docs/assets/8188636/a8ef381d-5af2-4bd5-8fa8-a919c74e09c8) 2. From the top-right menu, select "Settings" → "External service connection settings".
3. Open the VCam app, click the ⚙️ button, and enable mocopi from the "Integration" tab.\ ![image](https://github.com/vcamapp/docs/assets/8188636/6856dc9f-2b36-445f-a17d-da7b088344d3) 4. In the "External service connection settings" of the mocopi app, select the destination to "Stream support app", and then specify the IP address displayed in the VCam settings screen in step 3 and press OK. (Leave the port & the transfer format settings as is) ![image](/files/b9ED47XOdXAf0J6XCrG9) If the IP address does not appear, please refer to the following website or similar resources to check your Mac's IP address:\ ." 5. When you start motion capture in mocopi, it will be mirrored in VCam 🎉 ## Tips / Usage Techniques The mocopi app works even in the background. Therefore, you can connect to [VCamMocap](https://tattn.fanbox.cc/posts/5134895) and iFacialMocap simultaneously. ## Troubleshooting ### Cannot select an avatar in VCam The display position in mocopi's tracking might be offset. Tap the button below to adjust the position. ![image](https://github.com/vcamapp/docs/assets/8188636/ac6f636c-f31f-4d24-9280-bf50d1feee66) ### The mocopi app starts tracking, but it doesn't reflect in VCam Ensure your iPhone and Mac are connected to the same WiFi. Check if port "12351" is not blocked by security software. You can check the operation without mocopi using [BVH Sender](https://www.sony.net/Products/mocopi-dev/jp/downloads/DownloadInfo.html#BVH_Sender) (please specify the IP address as 127.0.0.1). If the motion from this app is not mirrored in VCam, there might be an issue with the network settings. Please check again. ### The movement in VCam is delayed by about 1 second compared to the mocopi app Try disconnecting and reconnecting in the mocopi app. ### Want to disconnect from mocopi Uncheck "Enable mocopi" from the Integration tab in the settings. Then select the tracking method in the Tracking tab. If you can't select "Hand," ensure the mocopi integration checkbox is unchecked.
### Cannot move forward or backward in mocopi Currently, only left and right movements are supported. Please wait for a future update for forward and backward movements. # Integrate with iPhone Tracking App You can integrate with apps that offer high-precision face tracking using the iPhone's TrueDepth camera (FaceID). Currently, the following apps are supported: * [VCamMocap](https://tattn.fanbox.cc/posts/5134895) * [iFacialMocap](https://www.ifacialmocap.com/home/japanese/) ## How to Integrate with VCamMocap Please refer to the page below: ## How to Integrate with iFacialMocap 1. Open the iFacialMocap app and check the iPhone's IP address. ![iFacialMocap](https://github.com/vcamapp/docs/assets/8188636/7d8dd8cd-cb77-41e9-973f-bc95a6d5d9fb) 2. Open the "Integration" menu in VCam, enter the IP address, and press the "Connect" button to integrate.\ ![image](https://github.com/vcamapp/docs/assets/8188636/18b2407f-ea88-435f-96fb-251ca212f4b5) 3. In the "Tracking" menu, changing the face tracking to "iFacialMocap" will reflect the tracking results in VCam.\ ![image](https://github.com/vcamapp/docs/assets/8188636/2d4ff470-3391-447f-a4f4-efa775ad8004) # FAQ ※ refer to clients like Zoom as "camera apps" in this document. ## **The app doesn't work** The app is currently in beta. There might be instances of instability.\ If you encounter any issues, reporting them to the developer with the following details might help in fixing them: ``` (Example) macOS version: 26.0 Chip: M4 Pro Memory: 24GB Camera app in use: Zoom Issue encountered: Initially, after launching this app and then starting Zoom, the avatar was displayed. However, after about an hour, the screen went blank. ``` For known issues and potential workarounds, please check the [Issue Information](/en/other/issue). ## **The app runs slow** We're constantly optimizing for better performance, so please use the latest version of the app.\ If it's still lagging, try the following in the settings window: * Lower "Rendering quality" in the "Rendering" tab * Lower "Screen resolution" in the "Rendering" tab (1280x720 is recommended for video conferences) * Lower "FPS (screen refresh rate)" in the "Rendering" tab * Lower "Camera FPS (tracking refresh rate)" in the "Tracking" tab * Set the tracking you don't use (hands, fingers, etc.) to "Disabled" * Offload tracking to an iPhone by using an [iPhone tracking app](/en/integration/iostrackingapp) ## **The screen doesn't display in the camera app** Please try the following to see if it resolves the issue: * Turn the camera in the camera app off and then back on. This might re-establish the connection and solve the problem. * Switch the camera app to an actual camera or another virtual camera and then switch back to VCam. This might also re-establish the connection. * Restart the camera app or VCam. * Reinstall the virtual camera. [Reference](/en/virtual-camera/virtualcamera) ## **Can't turn on the camera in the camera app** The virtual camera plugin of this app may have crashed. Please restart the camera app to reload the plugin. *Opening Console.app, selecting crash reports, and searching for 'caphost' (for Zoom) and then sharing the resulting report with the developer would be appreciated.* ## **Hands aren't moving properly** The avatar reflects the position of the hands as seen in the camera, not their actual position.\ This is to prevent issues like hands going out of the camera's view when raised directly upwards on devices like MacBooks. You can check this by opening QuickTime Player and selecting "New Movie Recording".\ For more details, please watch the following video:\ ## **The avatar went somewhere** Select the avatar and press the left arrow button to reset it to its original position. ![](https://user-images.githubusercontent.com/8188636/171683049-7c58e297-f3ed-46de-bb61-e38c056a2867.png) ## **Can I use it for streaming on platforms like YouTube?** Yes, you can. We'd appreciate it if you could share your broadcast using the "#VCam" hashtag! ## **Can I use it without the watermark (watermark) visible?** If you're using the app version with a watermark, please ensure the watermark is visible during usage.\ For our supporters, we offer a version of the app without a watermark. Please consider using that version if you're interested. [App without watermark is available here](https://vcamapp.com/download) ## **I want to use it on platforms other than macOS!** Once the development of the macOS version stabilizes, we'll consider developing for other platforms like Windows. As I'm developing this solo, it might take time. Thank you for your support :pray: # Bug Reports ### Issue Information If you find an issue that isn't listed below, I'd appreciate it if you could contact us via the "Contact Us" section at the bottom of [VCam](https://vcamapp.com/). [FAQ](/en/other/faq) ### Current versions (VCam 0.13 or later / VCam2D) * Lip sync might stop working when connecting a microphone like AirPods while VCam is running. * **Solution:** Please re-select the lip sync mode after connecting the microphone. Alternatively, restart VCam. * The accuracy of emotion (smile, etc.) estimation is low. * **Solution:** If you get unintended expressions, turn off "Estimate emotions with the microphone or camera" in the "Experiment" tab, and switch expressions with the expression buttons or shortcuts instead. * Combining the expression button with blinking and lip motion can distort the expression. (VCam) * **Solution:** When creating the blend shape for the VRM file, make sure that combining A and Blink with other expressions won't cause distortions. * Screen flickers in Zoom. * **Solution:** Reduce the FPS in the "Rendering" tab or the camera FPS in the "Tracking" tab. (It's possible that the tracking or screen update processing isn't keeping up.)
Past Issues #### Version 0.2.1 * The app crashes on devices without a built-in camera, like the Mac mini. #### Version 0.1.2 - 0.2.0 * The screen goes blank when resizing the window. * **Solution:** Repeated resizing might display the screen. Until it's fixed, please use it at that screen size. * The avatar's position might occasionally be off the screen when starting the app. * **Solution:** Press the "move to initial position" button. * Camera tracking might occasionally not work. * **Solution:** Turn off the camera use in settings, then turn it back on. #### Version 0.1.0 - 0.1.1 * The app might occasionally freeze, or crash upon closing. * The video might freeze when invoking the virtual camera in browser functions like Google Meet. * **Solution:** Use another virtual camera like OBS's to relay this app's video. * Camera tracking might not work on the initial startup. * **Solution:** Please restart the app.
# Support VCam Thank you for supporting VCam! Every gesture of support boosts our motivation for development. I truly appreciate it! I would be thrilled if you could share your VCam experiences on social media using the hashtag "#VCam". For those who wish to offer more proactive support, you can sponsor us through the platforms listed below: * [pixivFANBOX (ja)](https://tattn.fanbox.cc/plans) * [GitHub Sponsors](https://github.com/sponsors/tattn) * [Patreon](https://www.patreon.com/tattn) * [PayPal](https://www.paypal.com/paypalme/tattn) # VCam VCam은 가상 카메라를 이용해 아바타를 표시하는 macOS용 앱입니다. Zoom 등에서 카메라로 가상 아바타를 표시할 수 있습니다. 카메라를 사용할 수 없는 환경에서 리액션을 전달하고 싶을 때 편리합니다. [VCam 공식 웹사이트](https://vcamapp.com/ko) {% hint style="info" %} 앱 자체는 일본어와 영어만 지원합니다. macOS를 한국어로 사용하는 경우 앱은 영어로 표시되므로, 이 설명서에서는 화면에 표시되는 항목 이름을 영어로 적고 있습니다. {% endhint %} {% embed url="" %} {% embed url="" %} # 초기 설정 {% hint style="info" %} VCam은 반드시 "응용 프로그램(Applications)" 폴더에 설치해야 합니다. {% endhint %} 1. 앱을 실행합니다. 2. 마이크나 네트워크 사용 권한을 요청하는 창이 표시되면 허용합니다. 이 기능들은 아바타 조작과 가상 카메라 동작에 필수입니다. 3. 플러그인 설치 알림이 표시되면 설치를 진행합니다. 4. Zoom이나 OBS 등 가상 카메라를 사용하는 앱을 열고 아바타가 표시되는지 확인합니다. 아바타가 표시되지 않는 경우에는 [자주 묻는 질문](/ko/other/faq)을 참고하여 문제를 해결해 주세요. # 모델 불러오기 ## VCam 메뉴의 "File"에서 모델을 불러올 수 있습니다. 현재 로컬에 있는 [VRM 파일](https://vrm.dev/) 또는 [VRoid Hub](https://hub.vroid.com/)의 모델을 지원합니다.
모델 파일을 드래그 앤 드롭해서 불러올 수도 있습니다. 로컬 VRM 파일을 불러온 경우에는 앱을 다시 실행할 때 해당 모델이 자동으로 불러와집니다. VRoid Hub의 모델은 자동으로 설정되지 않으므로 다시 설정해 주세요. ### FBX나 MMD 파일을 불러오고 싶은 경우 Unity를 사용하면 다양한 형식의 파일을 VCam에서 불러올 수 있는 VRM 형식으로 변환할 수 있습니다. 변환 방법은 아래 문서를 참고해 주세요. {% embed url="" %} ## VCam2D 메뉴의 "File" 또는 드래그 앤 드롭으로 Live2D Cubism 모델을 불러올 수 있습니다. 아래와 같은 구성의 폴더를 선택해 주세요. ``` - 모델 폴더 - <모델 이름>.moc3 - 텍스처 폴더 - 텍스처 이미지1.png - 그 외 파일 (physics3.json, motions, expressions 폴더 등) ``` # 모델 사양 (VCam2D) VCam2D는 Live2D Cubism 모델을 제어하기 위해 다음 Live2D 파라미터를 사용합니다. ## 파라미터 목록 ### 몸의 움직임 | 파라미터 ID | 값의 범위 | 설명 | | --------------- | --------- | ----------------- | | ParamBodyAngleX | -10 \~ 10 | 몸의 X축 회전 (앞뒤 기울기) | | ParamBodyAngleY | -10 \~ 10 | 몸의 Y축 회전 (좌우 방향) | | ParamBodyAngleZ | -10 \~ 10 | 몸의 Z축 회전 (좌우 기울기) | ### 머리의 움직임 | 파라미터 ID | 값의 범위 | 설명 | | ----------- | --------- | --------------- | | ParamAngleX | -30 \~ 30 | 머리의 X축 회전 (위아래) | | ParamAngleY | -30 \~ 30 | 머리의 Y축 회전 (좌우) | | ParamAngleZ | -30 \~ 30 | 머리의 Z축 회전 (기울기) | ### 눈의 움직임 | 파라미터 ID | 값의 범위 | 설명 | | -------------- | ----------- | ---------------------------- | | ParamEyeLOpen | 0.0 \~ 1.0 | 왼쪽 눈의 열린 정도 (0.0=감음, 1.0=뜸) | | ParamEyeROpen | 0.0 \~ 1.0 | 오른쪽 눈의 열린 정도 (0.0=감음, 1.0=뜸) | | ParamEyeBallX | -1.0 \~ 1.0 | 시선의 X 방향 (좌우) | | ParamEyeBallY | -1.0 \~ 1.0 | 시선의 Y 방향 (위아래) | | ParamEyeLSmile | 0.0 \~ 1.0 | 왼쪽 눈의 웃는 표현 | | ParamEyeRSmile | 0.0 \~ 1.0 | 오른쪽 눈의 웃는 표현 | ### 입의 움직임 | 파라미터 ID | 대체 ID | 값의 범위 | 설명 | | --------------- | ------ | ---------- | -------------- | | ParamMouthOpenY | ParamA | 0.0 \~ 1.0 | 입이 열린 정도 | | ParamA | - | 0.0 \~ 1.0 | 모음 "あ(A)" 입 모양 | | ParamI | - | 0.0 \~ 1.0 | 모음 "い(I)" 입 모양 | | ParamU | - | 0.0 \~ 1.0 | 모음 "う(U)" 입 모양 | | ParamE | - | 0.0 \~ 1.0 | 모음 "え(E)" 입 모양 | | ParamO | - | 0.0 \~ 1.0 | 모음 "お(O)" 입 모양 | ### 그 외 표정 | 파라미터 ID | 값의 범위 | 설명 | | ----------- | ---------- | ---------- | | ParamBreath | 0.0 \~ 1.0 | 호흡 움직임 | | ParamCheek | 0.0 \~ 1.0 | 볼이 붉어지는 표현 | ## 기타 Live2D Cubism의 표준 파라미터에 대해서는 공식 문서를 참고해 주세요. * [Live2D Cubism 표준 파라미터 목록](https://docs.live2d.com/cubism-editor-manual/standard-parameter-list/) 또한 불러올 수 없는 모델이나 정상적으로 동작하지 않는 모델이 있는 경우에는 문의를 통해 알려 주세요. # 일반 설정 ⚙️ 버튼을 클릭하고 "General" 탭에서 다양한 설정을 변경할 수 있습니다. ## 대기 모션 무작위 재생 (Play idle motions) 무작위 대기 모션을 재생합니다. 트래킹을 끈 상태로 사용하고 싶을 때 추천합니다. ## 모델 메시 최적화 (Optimize meshes) 아바타 메시의 일부를 자동으로 결합하여 아바타 렌더링에 걸리는 부하를 줄입니다. 보통은 켜 두는 것을 권장하지만, 아바타 표시에 문제가 생기는 경우에는 끄고 모델을 다시 불러와 주세요. ## VRM 0.x 모델을 1.0으로 자동 변환 (Convert VRM 0.x to VRM 1.x) VRM 0.x 계열의 아바타를 VRM 1.0 계열로 자동 변환합니다. **앞으로 이 설정은 항상 켜진 상태가 됩니다.** 이 설정이 켜져 있어도 불러올 수 있는 0.x 모델을 제작하거나, 1.0 계열 모델을 준비하는 것을 권장합니다. 모델을 바로 수정할 수 없는 경우에는 끄고 사용해 주세요. ## 가상 카메라 화면 좌우 반전 (Flip screen of the virtual camera) 가상 카메라의 화면이 좌우로 반전되어 보이는 경우에 켜 주세요. ## macOS 메뉴 막대에 추가 (Add icon in macOS menu bar) VCam을 닫아도 Mac의 메뉴 막대에 추가된 상태로 유지됩니다. Mac의 메뉴 막대에 추가하면 다음과 같은 장점이 있습니다. * VCam을 매번 실행하지 않아도 가상 카메라를 사용하는 앱(OBS, Zoom 등)을 실행하기만 하면 웹캠 등이 자동으로 켜지고 아바타가 표시됩니다. * 가상 카메라를 사용하는 앱을 닫으면 웹캠 사용과 트래킹이 자동으로 중지됩니다. 메뉴 막대에 추가하지 않고 앱을 그대로 종료하고 싶은 경우에는 꺼 주세요. ## 언어 (Language) 현재 일본어와 영어를 지원합니다. 표시 언어는 macOS의 앱별 언어 설정을 따릅니다. 변경하려면 "Open the language settings of macOS"를 클릭하고, 시스템 설정에서 VCam의 언어를 선택해 주세요. # 트래킹 설정 아이콘을 클릭하거나 ⌘+, 를 누르면 설정 화면이 열립니다. "Tracking" 탭이 주요 트래킹 설정입니다.
## 트래킹 방식 변경하기
각 부위의 트래킹 방식은 처음에 "Default"로 설정되어 있습니다. 이는 Mac의 카메라로 트래킹하는 것을 의미합니다. 외부 앱과 연동하여 트래킹하거나, 트래킹을 끄는 것도 가능합니다. ## 사용할 장치 변경하기
외부 웹캠이나 마이크를 사용하고 싶은 경우에는 여기에서 변경할 수 있습니다. 립싱크(입 움직임) 방식을 카메라에서 마이크로 변경할 수도 있습니다. 또한 카메라를 사용하는 경우에는 모음을 추정하여 입 모양에 반영할 수도 있습니다. ## 눈 트래킹하기 카메라를 이용해 눈을 위아래, 좌우로 움직일 수 있게 합니다. ## 트래킹 품질 높이기 ### 카메라와의 위치 관계 웹캠 화면 중앙에 얼굴이 오도록 해 주세요. 얼굴과 카메라의 거리는 아래 이미지와 같은 비율을 권장합니다. QuickTime Player 등으로 카메라에 어떻게 비치는지 확인해 보세요. ![](https://user-images.githubusercontent.com/8188636/173237323-3f70184c-4efb-438d-8234-aa7fc9210e5d.png) ### 카메라 FPS 변경 카메라 FPS를 높은 값으로 설정하면 아바타가 더 부드럽게 움직입니다. 이 값을 높이면 AI 연산 부하가 커지므로, 사용 중인 Mac의 사양에 맞게 조정해 주세요. 최대값으로 설정하는 것을 권장합니다. # 가상 카메라 설정 VCam에는 가상 카메라라고 불리는 카메라 기능이 있습니다. 이 기능을 이용하면 Zoom이나 Google Meet 같은 화상 회의 앱에서도 VCam을 카메라로 인식하게 할 수 있습니다. ## 가상 카메라 설정하기 VCam 설정 화면의 "Virtual Camera"에서 동작 상태를 확인하고 가상 카메라를 설치하거나 제거할 수 있습니다. ![image](https://github.com/vcamapp/app/assets/8188636/a39c5c68-7215-42a4-bcf4-8a2f97cfb198) 설치 또는 제거한 후에는 Mac의 시스템 설정에서 "일반" → "로그인 항목 및 확장 프로그램" → "카메라 확장 프로그램"의 ⓘ 아이콘 → VCam.app의 CameraExtension을 활성화해야 합니다.
{% hint style="info" %} 현재 macOS에서는 플러그인을 설치하거나 제거할 때 Mac을 재시동해야 하는 경우가 있습니다. 정상적으로 동작하지 않는 경우에는 Mac을 재시동해 주세요. 또한 VCam이 "응용 프로그램(Applications)" 폴더에 설치되어 있어야 합니다. {% endhint %} ## 가상 카메라 사용 방법 카메라를 사용하는 앱의 카메라 목록에 "VCam - CameraExtension \[번호]"가 표시됩니다. ![zoom](https://github.com/vcamapp/docs/assets/8188636/288b4213-3320-4b36-b58a-ecc19c83eef3) "VCam - CameraExtension"을 선택하면 VCam의 영상을 표시할 수 있습니다. ## 가상 카메라 업데이트 VCam의 버전이 올라가면서 가상 카메라의 업데이트가 필요해지는 경우가 있습니다. 그런 경우에는 VCam 설정 화면의 "Virtual Camera"에서 "Reinstall"을 클릭해 주세요. 다시 설치한 후에는 VCam 앱을 재실행해 주세요. 현재 최신 버전은 "`VCam - CameraExtension [3]`"입니다. ## VCam과 VCam2D를 함께 사용할 때의 주의사항 VCam과 VCam2D는 같은 이름의 가상 카메라를 사용합니다. 두 앱을 모두 설치한 후 하나를 제거하면 가상 카메라가 정상적으로 동작하지 않는 경우가 있습니다. 그런 경우에는 계속 사용할 앱을 다시 설치해 주세요. # OBS와 연동하기 Mac용 OBS와 연동하여 VCam의 영상을 OBS에서 표시할 수 있습니다. ![OBS Studio](https://github.com/vcamapp/docs/assets/8188636/d76b22c8-84de-4b10-af07-cc757519b1cf) ## VCam OBS Plugin 사용하기 (권장) 이 방법은 다른 방법에 비해 부하를 줄일 수 있습니다. {% hint style="info" %} 이 플러그인을 사용하려면 가상 카메라가 활성화되어 있어야 합니다. 아직 활성화하지 않은 경우에는 [가상 카메라 설정](/ko/virtual-camera/virtualcamera)을 참고해 주세요. {% endhint %} ### 설치 아래에서 최신 버전의 .pkg 파일을 다운로드하고 파일을 열어 설치합니다.\ 설치한 후에는 OBS Studio를 재실행해 주세요. {% embed url="" %} ### 사용 방법 1. OBS Studio의 소스에서 "+" 버튼을 클릭하고 "VCam"을 선택하여 소스에 추가합니다. 2. VCam 앱을 실행합니다. 3. OBS Studio에 VCam의 영상이 표시됩니다. ### 크로마키 없이 배경을 투명하게 만들기 VCam의 배경 선택에서 배경색을 선택합니다.
그리고 불투명도를 0%로 설정하면 OBS에서 배경이 투명해집니다.
## VCam을 영상 장치로 사용하기 1. 소스 추가 버튼에서 "비디오 캡처 장치"를 선택하고 새로 만듭니다.
2. 장치에서 "VCam - CameraExtension \[번호]"를 선택합니다.
* 미리 VCam을 실행해 두었다면 미리보기가 표시됩니다. 선택한 후에 VCam을 실행한 경우에는 장치 목록에서 다른 장치를 선택한 다음 VCam을 다시 선택하면 미리보기가 표시됩니다. 3. 소스를 Ctrl+클릭하고 메뉴에서 "필터"를 선택합니다. ![image](https://user-images.githubusercontent.com/8188636/154321674-cdf851d8-e375-4193-9481-f8f55ce91b64.png) 4. 이펙트 필터 추가 버튼을 클릭하고 "크로마 키"를 선택합니다. ![image](https://user-images.githubusercontent.com/8188636/154321774-076ca337-bb98-4911-bb56-359b3c07ee54.png) 5. VCam의 배경색에 맞춰 색상 키를 설정하면 배경색을 지울 수 있습니다. ![image](https://user-images.githubusercontent.com/8188636/154322044-acf1ea4a-37b7-4b88-ae27-bcaa61a405e8.png) 6. (창 크기에 따라 여백이 생기는 경우에는) 이펙트 필터에 "크롭/패드"를 추가하면 검은 띠를 없앨 수 있습니다. ![image](https://user-images.githubusercontent.com/8188636/154323204-aa42c68c-3749-49b5-9902-00c2346e953b.png) 이제 아바타와 게임 영상 등을 자유롭게 합성할 수 있습니다.\ VCam은 앱을 최소화한 상태에서도 대부분의 기능이 동작하므로, 조작 창이 필요하지 않은 분은 최소화해 보세요. # mocopi와 연동하기 (VCam) VCam은 Sony의 모션 캡처 장비 "mocopi"와의 연동을 지원합니다. {% embed url="" %} ## 연동 방법 1. mocopi 앱을 실행하고 모션 캡처를 시작합니다. 자세한 순서는 mocopi 앱의 안내를 따라 주세요. ![image](https://github.com/vcamapp/docs/assets/8188636/a8ef381d-5af2-4bd5-8fa8-a919c74e09c8) 2. 오른쪽 위 메뉴에서 "설정" → "외부 서비스 연결 설정"을 선택합니다.
3. VCam 앱을 열고 ⚙️ 버튼을 클릭한 다음, "Integration" 탭에서 mocopi를 활성화합니다.\ ![image](https://github.com/vcamapp/docs/assets/8188636/6856dc9f-2b36-445f-a17d-da7b088344d3) 4. mocopi 앱의 "외부 서비스 연결 설정"에서 전송 대상을 "방송 지원 앱"으로 선택합니다. 그다음 3번의 VCam 설정 화면에 표시된 Info의 IP 주소를 "IP 주소"에 입력하고 OK를 누릅니다. (포트 설정과 전송 형식은 그대로 두세요) ![image](/files/8bAmyUTe1mf9hkYjzkkK) IP 주소가 표시되지 않는 경우에는 아래 사이트 등을 참고하여 Mac의 IP 주소를 확인해 주세요.\ 5. mocopi에서 모션 캡처를 시작하면 VCam에 반영됩니다 🎉 ## Tips / 활용 방법 mocopi 앱은 백그라운드에서도 동작합니다. 그래서 [VCamMocap](https://vcamapp.com/ko/vcammocap)이나 iFacialMocap도 동시에 연결할 수 있습니다. ## 문제 해결 ### VCam에서 아바타를 클릭해 선택할 수 없다 mocopi 트래킹의 표시 위치가 어긋났을 가능성이 있습니다. 아래 버튼을 탭해서 위치를 보정해 주세요. ![image](https://github.com/vcamapp/docs/assets/8188636/ac6f636c-f31f-4d24-9280-bf50d1feee66) ### mocopi 앱에서는 트래킹이 시작되었는데 VCam에 반영되지 않는다 iPhone과 Mac이 같은 Wi-Fi에 연결되어 있는지 확인해 주세요. 또한 보안 소프트웨어 등으로 포트 "12351"이 차단되어 있지 않은지 확인해 주세요. [BVH Sender](https://www.sony.net/Products/mocopi-dev/jp/downloads/DownloadInfo.html#BVH_Sender)를 사용하면 mocopi 없이도 동작을 확인할 수 있습니다 (IP 주소는 127.0.0.1을 지정해 주세요). 이 앱의 모션이 VCam에 반영된다면 네트워크 관련 설정에 문제가 있을 가능성이 높습니다. 다시 확인해 주세요. ### VCam의 움직임이 mocopi 앱보다 1초 정도 지연된다 mocopi 앱에서 연결을 한 번 해제한 다음 다시 연결해 보세요. ### mocopi 연동을 해제하고 싶다 설정 화면의 "Integration" 탭에서 mocopi 활성화 체크를 해제합니다. 그다음 "Tracking" 탭에서 트래킹 방식을 선택해 주세요. "Hand"를 선택할 수 없는 경우에는 mocopi 연동 체크가 해제되어 있는지 확인해 주세요.
### mocopi에서 앞뒤로 움직일 수 없다 현재는 좌우 움직임만 반영되는 사양입니다. 앞뒤 움직임은 향후 업데이트를 기다려 주세요. # iPhone 트래킹 앱과 연동하기 iPhone의 TrueDepth 카메라(Face ID)를 사용해 고정밀 페이스 트래킹을 수행하는 앱과 연동할 수 있습니다. 현재 다음 앱을 지원합니다. * [VCamMocap](https://vcamapp.com/ko/vcammocap) * [iFacialMocap](https://www.ifacialmocap.com/home/japanese/) ## VCamMocap과 연동하는 방법 아래 페이지를 참고해 주세요. ## iFacialMocap과 연동하는 방법 1. iFacialMocap 앱을 열고 iPhone의 IP 주소를 확인합니다. ![iFacialMocap](https://github.com/vcamapp/docs/assets/8188636/7d8dd8cd-cb77-41e9-973f-bc95a6d5d9fb) 2. VCam의 "Integration" 탭을 열고 IP 주소를 입력한 다음 "Connect" 버튼을 누르면 연동됩니다.\ ![image](https://github.com/vcamapp/docs/assets/8188636/18b2407f-ea88-435f-96fb-251ca212f4b5) 3. "Tracking" 탭에서 얼굴 트래킹을 "iFacialMocap"으로 변경하면 트래킹 결과가 VCam에 반영됩니다.\ ![image](https://github.com/vcamapp/docs/assets/8188636/2d4ff470-3391-447f-a4f4-efa775ad8004) # 자주 묻는 질문 ※ Zoom 등의 클라이언트를 "카메라 앱"으로 표기합니다. ## **앱이 동작하지 않는다** 이 앱은 현재 베타 버전입니다. 동작이 불안정한 경우가 있습니다.\ 불편 사항은 아래 정보와 함께 개발자에게 알려 주시면 수정할 수 있는 경우가 있습니다. ``` (예시) macOS 버전: 26.0 칩: M4 Pro 메모리: 24GB 사용 중인 카메라 앱: Zoom 문제 내용: 먼저 이 앱을 실행하고 그다음 Zoom을 실행했을 때, 처음에는 아바타가 표시되었지만 1시간 정도 지나자 화면이 표시되지 않게 되었습니다. ``` 이미 알려진 문제의 회피 방법은 [알려진 문제](/ko/other/issue)에 정리되어 있으니 확인해 주세요. ## **동작이 무겁다** 성능 개선을 계속 진행하고 있으므로 최신 버전 앱을 사용해 주세요.\ 그래도 무거운 경우에는 설정 화면에서 아래 항목을 시도해 보세요. * "Rendering" 탭에서 "Rendering quality"(렌더링 품질)를 낮추기 * "Rendering" 탭에서 "Screen resolution"(화면 해상도)을 낮추기 (화상 회의에서는 1280x720을 권장합니다) * "Rendering" 탭에서 "FPS (screen refresh rate)"(화면 갱신 빈도)를 낮추기 * "Tracking" 탭에서 "Camera FPS (tracking refresh rate)"(트래킹 갱신 빈도)를 낮추기 * 사용하지 않는 트래킹(손, 손가락 등)을 "Disabled"로 설정하기 * [iPhone 트래킹 앱](/ko/integration/iostrackingapp)과 연동하여 트래킹 처리를 iPhone에 맡기기 ## **카메라 앱에 화면이 표시되지 않는다** 아래 방법을 시도하여 개선되는지 확인해 주세요. * 카메라 앱의 카메라를 끈 다음 다시 켜 주세요. 이렇게 하면 재연결이 이루어져 개선되는 경우가 있습니다. * 카메라 앱의 카메라를 실제 카메라나 다른 가상 카메라로 전환한 다음 다시 VCam으로 되돌려 주세요. 이렇게 하면 재연결이 이루어져 개선되는 경우가 있습니다. * 카메라 앱이나 VCam을 재실행해 주세요. * 가상 카메라를 다시 설치해 주세요. [참고](/ko/virtual-camera/virtualcamera) ## **카메라 앱에서 카메라를 켤 수 없다** 이 앱의 가상 카메라 플러그인이 충돌한 상태입니다. 카메라 앱을 재실행하여 플러그인을 다시 불러와 주세요. *Console.app을 열고 크래시 리포트를 선택한 다음, Zoom이라면 "caphost"로 검색해서 표시되는 리포트를 개발자에게 알려 주시면 감사합니다.* ## **손이 잘 움직이지 않는다** 실제 사람의 손 위치가 아니라 카메라에 비치는 손 위치를 기준으로 아바타에 반영하고 있습니다.\ 이는 MacBook 등에서 손을 위로 들었을 때 카메라 밖으로 나가 버리는 문제를 방지하기 위한 것입니다. QuickTime Player를 열고 "새로운 동영상 녹화"를 클릭해서 카메라에 어떻게 비치는지 확인해 보세요.\ 자세한 내용은 아래 동영상을 참고해 주세요.\ ## **아바타가 어딘가로 사라졌다** 아바타를 선택하고 왼쪽 화살표 버튼을 누르면 초기 위치로 돌아갑니다. ![](https://user-images.githubusercontent.com/8188636/171683049-7c58e297-f3ed-46de-bb61-e38c056a2867.png) ## **YouTube 등의 방송에 사용해도 되나요?** 사용 가능합니다. "#VCam" 해시태그로 방송을 공유해 주시면 정말 기쁩니다! ## **워터마크를 보이지 않게 하고 사용해도 되나요?** 워터마크가 있는 앱을 사용하는 경우에는 반드시 워터마크가 보이는 상태로 사용해 주세요.\ 후원해 주시는 분에게는 워터마크가 없는 앱을 배포하고 있습니다. 그런 용도로 사용하고 싶은 경우에는 이쪽을 검토해 주세요. [워터마크가 없는 앱은 여기에서](https://vcamapp.com/ko/download) ## **macOS 이외에서 사용하고 싶다!** macOS 버전 개발이 안정되면 Windows 버전 등의 개발도 검토할 예정입니다. 혼자서 개발하고 있어서 시간이 걸리지만 응원 부탁드립니다 :pray: # 알려진 문제 ### 알려진 문제 아래에 없는 문제를 발견하신 분은 [VCam](https://vcamapp.com/ko) 하단의 "문의하기"를 통해 알려 주시면 감사합니다. [자주 묻는 질문](/ko/other/faq) ### 현재 버전 (VCam 0.13 이상 / VCam2D) * VCam 실행 중에 AirPods 등의 마이크를 연결하면 립싱크가 동작하지 않는 경우가 있다 * 【해결 방법】 마이크를 연결한 후 립싱크 방식을 다시 선택해 주세요. 또는 VCam을 재실행해 주세요. * 감정(웃는 표정 등) 추정의 정확도가 낮다 * 【해결 방법】 의도하지 않은 표정이 되는 경우에는 "Experiment" 탭의 "Estimate emotions with the microphone or camera"를 끄고, 표정 버튼이나 단축키로 표정을 전환해 주세요. * 표정 버튼과 눈 깜빡임, 입 움직임을 조합하면 표정이 깨진다 (VCam) * 【해결 방법】 VRM 파일의 블렌드 셰이프를 제작할 때 A와 Blink를 다른 표정과 조합해도 깨지지 않도록 만들어 주세요. * Zoom에서 화면이 깜빡인다 * 【해결 방법】 "Rendering" 탭의 FPS나 "Tracking" 탭의 카메라 FPS를 낮춰 주세요. (트래킹이나 화면 갱신 처리가 따라가지 못하는 경우가 있습니다)
과거의 문제 #### 버전 0.2.1 * Mac mini 등 기본 카메라가 없는 기기에서 앱이 충돌한다 #### 버전 0.1.2 \~ 0.2.0 * 창 크기를 조절하면 화면이 표시되지 않게 된다 * 【해결 방법】 여러 번 크기를 조절하면 화면이 표시됩니다. 수정될 때까지는 해당 화면 크기로 사용해 주세요. * 앱을 실행하면 아바타의 위치가 화면 밖으로 나가는 경우가 있다 * 【해결 방법】 초기 위치로 이동하는 버튼을 눌러 주세요. * 간혹 카메라 트래킹이 동작하지 않는다 * 【해결 방법】 설정에서 카메라 사용을 끈 다음 다시 켜 주세요. #### 버전 0.1.0 \~ 0.1.1 * 앱이 드물게 멈추거나, 앱을 종료할 때 충돌한다 * Google Meet 등 브라우저 기능으로 가상 카메라를 호출하면 영상이 멈추는 경우가 있다 * 【해결 방법】 OBS의 가상 카메라 등을 경유해서 이 앱의 영상을 보내 주세요. * 처음 실행할 때 카메라 트래킹이 동작하지 않는다 * 【해결 방법】 앱을 재실행해 주세요.
# VCam 후원하기 VCam을 응원해 주셔서 감사합니다! 하나하나의 응원이 개발의 동기가 됩니다. 정말 감사합니다! SNS 등에서 "#VCam" 해시태그를 붙여 사용하시는 모습을 공유해 주시면 정말 기쁩니다! 더 적극적으로 응원해 주고 싶은 분은 아래에서 후원할 수 있습니다. * [pixivFANBOX (ja)](https://tattn.fanbox.cc/plans) * [GitHub Sponsors](https://github.com/sponsors/tattn) * [Patreon](https://www.patreon.com/tattn) * [PayPal](https://www.paypal.com/paypalme/tattn)