โปรไฟล์อวาตาร์ (แผนผังเบลนด์เชปการแสดงสีหน้า)

ให้วางโปรไฟล์ไว้ในโฟลเดอร์ avatar_profiles ซึ่งอยู่ในโฟลเดอร์เดียวกับตัวโปรแกรม Avatar Viewer

1. เปิด Avatar Viewer แล้วกดปุ่ม สตรีมมิง บนแถบเครื่องมือ
2. กด เปิดโฟลเดอร์ ในหัวข้อ "โปรไฟล์อวาตาร์" แล้วโฟลเดอร์ avatar_profiles จะเปิดขึ้นใน Explorer
3. คัดลอก sample.toml ในโฟลเดอร์ แล้วเปลี่ยนชื่อเป็นชื่ออวาตาร์ของคุณหรือชื่ออื่น (เช่น my_avatar.toml)
4. เปิดไฟล์ด้วยโปรแกรมแก้ไขข้อความ (Notepad, VS Code ฯลฯ) แล้วแก้ไข

โครงสร้างขั้นต่ำมีเพียง name ที่ต้นไฟล์ และบล็อก [[expressions]] เรียงต่อกันตามจำนวนที่ต้องการเท่านั้น

name = "マイアバター"

[[expressions]]
source   = "Joy"
target   = "face_happy"
renderer = "Body"

[[expressions]]
source   = "Blink"
target   = "eye_close"
renderer = "Body"

[[expressions]]
source   = "A"
target   = "mouth_a"
renderer = "Body"

ความหมายของแต่ละฟิลด์มีดังนี้

ชื่อการแสดงออกที่ระบุใน source ได้เป็นไปตามมาตรฐาน VRM ตามหมวดหมู่ด้านล่าง โดยไม่แยกตัวพิมพ์เล็ก/ใหญ่

ใน target ให้ใส่ชื่อเบลนด์เชปการแสดงออกที่มีอยู่จริงในอวาตาร์ตามตัวอักษรทุกตัว ชื่อเหล่านี้แตกต่างกันมากตามผู้สร้างและรูปแบบการตั้งชื่อ จึงต้องตรวจสอบก่อน

วิธี A: ตรวจสอบใน Unity (ก่อนเอ็กซ์พอร์ต)

1. เปิดอวาตาร์ใน Unity
2. เลือกเมชใบหน้าใน Hierarchy (ส่วนใหญ่คือ Body หรือ Face)
3. ขยาย SkinnedMeshRenderer → BlendShapes ใน Inspector
4. ชื่อที่แสดงอยู่ใช้เป็น target ได้ทันที และชื่อ GameObject ที่เลือกก็คือค่าของ renderer

วิธี B: ตรวจสอบจากล็อกของ Viewer

หากชื่อ target หรือชื่อ renderer ผิด Viewerจะแสดงล็อกคำเตือน การสร้างโปรไฟล์ด้วยชื่อชั่วคราวแล้วโหลดดู จากนั้นค่อยแก้เป็นชื่อที่ถูกต้องไปพร้อมกับดูล็อก ก็เป็นวิธีที่ใช้ได้จริง

ความแรงของการแสดงออกที่รับเข้ามา (0.0〜1.0) จะถูกประมาณค่าเชิงเส้นระหว่าง min_weight ถึง max_weight แล้วนำไปใช้กับเบลนด์เชปการแสดงออก หากละไว้ ค่าจะเป็น 0 〜 100 (= ขยับได้เต็ม 100%)

# 笑顔を少し控えめにしたい
[[expressions]]
source     = "Joy"
target     = "face_happy"
renderer   = "Body"
max_weight = 60

# 常に少しだけ口角を上げておきたい(下駄を履かせる)
[[expressions]]
source     = "neutral"
target     = "face_smile_slight"
renderer   = "Body"
min_weight = 20
max_weight = 40

หากไม่ได้เขียน renderer Viewerจะไล่ตรวจ SkinnedMeshRenderer ทั้งหมดในอวาตาร์ตามลำดับ แล้วนำไปใช้กับตัวแรกที่มีเบลนด์เชปการแสดงออกตาม target ที่ระบุ

พฤติกรรมนี้สะดวกก็จริง แต่หากเมชอื่นอย่างชุดหรือผมมีเบลนด์เชปการแสดงออกชื่อเดียวกัน เมชที่ไม่ได้ตั้งใจอาจขยับแทนได้ โดยทั่วไปจึงแนะนำให้ระบุ renderer อย่างชัดเจน

1. แสดงอวาตาร์ใน Avatar Viewer
2. เปิด สตรีมมิง บนแถบเครื่องมือ
3. กดปุ่มเลือกของ "โปรไฟล์อวาตาร์" แล้วเลือกโปรไฟล์ที่ต้องการจากรายการ
4. เมื่อเปิดการรับ VMC เบลนด์เชปการแสดงออกที่จับคู่ไว้จะเริ่มขยับ

• ไม่มีผลใดๆ เลย สาเหตุหลักคือสะกด source ผิด ใส่ชื่อเบลนด์เชปการแสดงออกที่ไม่มีอยู่จริงใน target หรือชื่อ renderer ไม่ตรง กรุณาตรวจสอบชื่อที่ถูกต้องด้วยวิธี A ใน Step 4
• เมชอื่นขยับแทน หากละ renderer ไว้ อาจไปจับคู่กับเมชอื่นที่มีเบลนด์เชปการแสดงออกชื่อเดียวกัน กรุณาระบุ renderer ให้ชัดเจน
• สีหน้าแรงหรืออ่อนเกินไป ปรับค่าสูงสุดด้วย max_weight และค่าชดเชยคงที่ด้วย min_weight
• ต้องการให้การแสดงออกเดียวขยับเบลนด์เชปการแสดงออกหลายตัว เรียงบล็อก [[expressions]] ที่มี source เดียวกันหลายบล็อก แล้วจะขยับพร้อมกัน
• โปรไฟล์ไม่แสดงในรายการ ตรวจสอบว่านามสกุลไฟล์เป็น .toml และวางไฟล์ไว้ในโฟลเดอร์ avatar_profiles โดยตรง ไฟล์ชื่อ sample.toml จะไม่แสดงในรายการ