[Unity Facial Test] FaceBridge

非商用目的でご利用の場合は、「個人利用向け (Personal Use)」をご購入ください。

収益化などの商用目的でご利用の場合は、「商用利用可 (Commercial Use Allowed)」をご購入ください。

비상업적 용도로 사용하실 경우 ‘個人利用向け (Personal Use)’를 구매해 주세요.

수익 창출 등 상업적 용도로 사용하실 경우 ‘商用利用可 (Commercial Use Allowed)’를 구매해 주시기 바랍니다.

If you intend to use this for non-commercial purposes, please purchase “個人利用向け (Personal Use)”

If you intend to use this for commercial purposes, including generating revenue, please purchase “商用利用可 (Commercial Use Allowed)”

日本語

Unity 上で Facial 機能をテストするためのツールです。

使用方法:

1. VRCFT を起動します。

2. iPhone やヘッドセットなどで Facial Tracking を接続します。

3. Unity 上部メニューから Studio Iyan/Tools/FaceBridge を選択します。

4. アバターをドラッグ＆ドロップします。

5. Play Mode に入ります。

6. Animator を検索 -> Runtime Bridge を検索 -> Runtime Bridge を追加 の順に押します。

7. Facial が動作していることを確認します。

FAQ

Facial が動作しません 1:

VRChat で OSC が有効になっている場合、9000 番ポートがすでに使用されているため、正常に動作しません。VRChat または OSC を終了して、9000 番ポートを使用できる状態にしてから再度お試しください。

Facial が動作しません 2:

まだテストしていないアセットである可能性があります。このドキュメント下部に記載されていない Facial アセットで使用した場合は、該当アセットのリンクと一緒にお問い合わせください。

한국어

Unity 상에서 Facial 기능을 테스트 할 수 있는 툴 입니다.

사용방법:

1. VRCFT를 킵니다.

2. 아이폰이나 헤드셋 등을 통하여 페이셜을 연결합니다.

3. 유니티 상단의 Studio Iyan/Tools/FaceBridge를 선택합니다.

4. 아바타를 드래그&드롭 합니다.

5. Play Mode에 진입합니다.

6. '애니메이터 찾기' -> '런타임 브리지 찾기' -> '런타임 브리지 추가' 순서대로 누릅니다.

7. 이제 페이셜이 작동되는 것을 확인합니다.

FAQ

페이셜이 작동하지 않아요 1:

VRChat에서 OCS를 실행하고 있는 경우에는 9000번 포트가 이미 사용 중이라 제대로 작동하지 않습니다. VRChat이나 OCS를 꺼서 9000번 포트를 사용 가능하게 만들고 다시 시도해주세요.

페이셜이 작동하지 않아요 2:

아직 테스트해보지 못한 에셋일 경우가 있습니다. 이 문서 최하단에 적혀있지 않은 Facial 에셋으로 사용하신 경우는, 해당 에셋 링크와 함께 문의 부탁드립니다.

English

This tool is for testing Facial functionality inside Unity.

Tested with Fermata Shop's Airi's FacialTracking Setting.

Operation is not guaranteed in other environments, but if you contact us through BOOTH, we will help as quickly as possible.

How to use:

1. Launch VRCFT.

2. Connect facial tracking through an iPhone, headset, or other supported device.

3. In Unity, select Studio Iyan/Tools/FaceBridge from the top menu.

4. Drag and drop your avatar.

5. Enter Play Mode.

6. Click Find Animator -> Find Runtime Bridge -> Add Runtime Bridge in order.

7. Confirm that facial tracking is working.

FAQ

Facial tracking is not working 1:

If OSC is enabled in VRChat, port 9000 may already be in use, so FaceBridge will not work correctly. Close VRChat or disable OSC so port 9000 becomes available, then try again.

Facial tracking is not working 2:

The asset may not have been tested yet. If you are using a Facial asset that is not listed at the bottom of this document, please contact us with a link to that asset.

Test by

Fermata Shop / Airi's FacialTracking Setting

Fermata Shop / Chocolat's FacialTracking Setting

それ以外の環境での動作は保証していませんが、BOOTH からお問い合わせいただければ、できるだけ早くサポートします。

이 외의 환경에서는 동작을 보장하지 않으나, 부스를 통하여 문의 주신다면 빠르게 도와드리겠습니다.

Operation is not guaranteed in other environments, but if you contact us through BOOTH, we will help as quickly as possible.

Change Log

1.0.2

- Switched release automation from VPM listing updates to Booth-ready `.unitypackage` release assets.

- Removed standalone VPM repository distribution.

1.0.1

- Changed VPM distribution to use this repository's standalone `facebridge.json` listing.

- Removed FaceBridge from the shared Studio Iyan VPM listing flow.

1.0.0

- Promoted FaceBridge to the first stable preview release.

- Added VRChat OSC emulation for VRCFT preview while VRChat is closed.

- Added VRChat-style OSC avatar config writing from a packaged VRCFT parameter template.

- Added `/avatar/change` sending to VRCFT.

- Added support for OSC bundles and multi-message packets.

- Added raw OSC packet logging with address, type tags, values, bytes, and hex preview.

- Added collapsible Status, Received Parameters, and Raw OSC Messages sections.

- Added Japanese, Korean, and English language buttons to the FaceBridge window.

- Added the tool name and version display to the FaceBridge window header.

- Added VRCFT `v2/*` parameter handling.

- Added `OSCm/Proxy/v2/*` parameter candidate support.

- Added VRCFT binary parameter decoding for `1`, `2`, `4`, `8`, and `Negative` flag patterns.

- Added binary flag application to Animator Bool, Float, and Int parameters.

- Added signed float split mapping for positive and negative VRCFT parameters.

- Added native `/tracking/eye/*` fallback mapping for eye direction and eyelids.

- Added suppression of fixed avatar eye parameter echoes while native eye tracking packets are active.

- Added automatic tracking gate parameter enablement for common VRCFT/OSCmooth controllers.

- Added runtime Animator discovery from the avatar descriptor FX controller in PlayMode.

- Updated default settings to match the stable preview layout.

- Improved Animator parameter cache handling for controller changes during PlayMode.

- Improved diagnostics for ignored packets, unknown parameters, failed applies, and last applied values.

0.1.0

- Initial MVP.

- Added UDP OSC receive support.

- Added minimal OSC parser for float, int, and bool avatar parameters.

- Added Animator parameter injection.

- Added FaceBridge Editor Window.

- Added manual test slider.

Credit

Thumbnail: ChatGPT-assisted