> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/mappings-reference.md). # 映射参考 ## **ARKit（61 个形态）** 52 个面部混合形状 + 9 个旋转值（头部 + 眼睛） ```json [ "EyeBlinkLeft", "EyeLookDownLeft", "EyeLookInLeft", "EyeLookOutLeft", "EyeLookUpLeft", "EyeSquintLeft", "EyeWideLeft", "EyeBlinkRight", "EyeLookDownRight", "EyeLookInRight", "EyeLookOutRight", "EyeLookUpRight", "EyeSquintRight", "EyeWideRight", "JawForward", "JawRight", "JawLeft", "JawOpen", "MouthClose", "MouthFunnel", "MouthPucker", "MouthRight", "MouthLeft", "MouthSmileLeft", "MouthSmileRight", "MouthFrownLeft", "MouthFrownRight", "MouthDimpleLeft", "MouthDimpleRight", "MouthStretchLeft", "MouthStretchRight", "MouthRollLower", "MouthRollUpper", "MouthShrugLower", "MouthShrugUpper", "MouthPressLeft", "MouthPressRight", "MouthLowerDownLeft", "MouthLowerDownRight", "MouthUpperUpLeft", "MouthUpperUpRight", "BrowDownLeft", "BrowDownRight", "BrowInnerUp", "BrowOuterUpLeft", "BrowOuterUpRight", "CheekPuff", "CheekSquintLeft", "CheekSquintRight", "NoseSneerLeft", "NoseSneerRight", "TongueOut", "HeadYaw", "HeadPitch", "HeadRoll", "LeftEyeYaw", "LeftEyePitch", "LeftEyeRoll", "RightEyeYaw", "RightEyePitch", "RightEyeRoll"] ``` ## MetaHuman（251 个形态） ### 分类概览 ```typescript // MetaHuman（251 个形态）— Unreal Engine MetaHuman CTRL_expressions_* [ // 眉毛（0–7）— 8 个控件 "CTRL_expressions_browDownL", "CTRL_expressions_browDownR", "CTRL_expressions_browRaiseInL", "CTRL_expressions_browRaiseInR", // 另外 4 个眉毛控件 // 耳朵（8–9）— 2 个控件 "CTRL_expressions_earUpL", "CTRL_expressions_earUpR", // 眼睛（10–42）— 33 个控件 "CTRL_expressions_eyeBlinkL", "CTRL_expressions_eyeBlinkR", "CTRL_expressions_eyeLookUpL", "CTRL_expressions_eyeLookUpR", "CTRL_expressions_eyePupilWideL", "CTRL_expressions_eyePupilWideR", // 另外 27 个眼睛控件 // 睫毛（43–50）— 8 个控件 "CTRL_expressions_eyelashesUpINL", "CTRL_expressions_eyelashesUpINR", "CTRL_expressions_eyelashesDownOUTL","CTRL_expressions_eyelashesDownOUTR", // 另外 4 个睫毛控件 // 下颌（51–64）— 14 个控件 "CTRL_expressions_jawOpen", // 对口型同步最重要 "CTRL_expressions_jawLeft", "CTRL_expressions_jawRight", "CTRL_expressions_jawClenchL", "CTRL_expressions_jawClenchR", // 另外 9 个下颌控件 // 嘴部（65–192）— 128 个控件（详细的口型同步） "CTRL_expressions_mouthFunnelDL", "CTRL_expressions_mouthFunnelDR", "CTRL_expressions_mouthCornerUpL","CTRL_expressions_mouthCornerUpR", "CTRL_expressions_mouthLipsPressL","CTRL_expressions_mouthLipsPressR", "CTRL_expressions_mouthUpperLipRaiseL","CTRL_expressions_mouthUpperLipRaiseR", // 另外 120 个嘴部控件 // 颈部与喉部（193–206）— 14 个控件 "CTRL_expressions_neckStretchL", "CTRL_expressions_neckStretchR", "CTRL_expressions_neckSwallowPh1","CTRL_expressions_neckSwallowPh2", "CTRL_expressions_neckThroatInhale","CTRL_expressions_neckThroatExhale", // 另外 8 个颈部与喉部控件 // 鼻子（207–218）— 12 个控件 "CTRL_expressions_noseWrinkleL", "CTRL_expressions_noseWrinkleR", "CTRL_expressions_noseNostrilDilateL","CTRL_expressions_noseNostrilDilateR", // 另外 8 个鼻部控件 // 牙齿（219–230）— 12 个控件 "CTRL_expressions_teethUpD", "CTRL_expressions_teethUpU", "CTRL_expressions_teethFwdD","CTRL_expressions_teethFwdU", // 另外 8 个牙齿控件 // 舌头（231–250）— 20 个控件 "CTRL_expressions_tongueOut", "CTRL_expressions_tongueIn", "CTRL_expressions_tongueTipUp","CTRL_expressions_tongueTipDown", "CTRL_expressions_tongueLeft","CTRL_expressions_tongueRight", // 另外 14 个舌头控件 ] ``` ### MetaHuman 251 个混合形状数组（JSON 格式） ```json [ "CTRL_expressions_browDownL", "CTRL_expressions_browDownR", "CTRL_expressions_browLateralL", "CTRL_expressions_browLateralR", "CTRL_expressions_browRaiseInL", "CTRL_expressions_browRaiseInR", "CTRL_expressions_browRaiseOuterL", "CTRL_expressions_browRaiseOuterR", "CTRL_expressions_earUpL", "CTRL_expressions_earUpR", "CTRL_expressions_eyeBlinkL", "CTRL_expressions_eyeBlinkR", "CTRL_expressions_eyeCheekRaiseL", "CTRL_expressions_eyeCheekRaiseR", "CTRL_expressions_eyeFaceScrunchL", "CTRL_expressions_eyeFaceScrunchR", "CTRL_expressions_eyeLidPressL", "CTRL_expressions_eyeLidPressR", "CTRL_expressions_eyeLookDownL", "CTRL_expressions_eyeLookDownR", "CTRL_expressions_eyeLookLeftL", "CTRL_expressions_eyeLookLeftR", "CTRL_expressions_eyeLookRightL", "CTRL_expressions_eyeLookRightR", "CTRL_expressions_eyeLookUpL", "CTRL_expressions_eyeLookUpR", "CTRL_expressions_eyeLowerLidDownL", "CTRL_expressions_eyeLowerLidDownR", "CTRL_expressions_eyeLowerLidUpL", "CTRL_expressions_eyeLowerLidUpR", "CTRL_expressions_eyeParallelLookDirection", "CTRL_expressions_eyePupilNarrowL", "CTRL_expressions_eyePupilNarrowR", "CTRL_expressions_eyePupilWideL", "CTRL_expressions_eyePupilWideR", "CTRL_expressions_eyeRelaxL", "CTRL_expressions_eyeRelaxR", "CTRL_expressions_eyeSquintInnerL", "CTRL_expressions_eyeSquintInnerR", "CTRL_expressions_eyeUpperLidUpL", "CTRL_expressions_eyeUpperLidUpR", "CTRL_expressions_eyeWidenL", "CTRL_expressions_eyeWidenR", "CTRL_expressions_eyelashesDownINL", "CTRL_expressions_eyelashesDownINR", "CTRL_expressions_eyelashesDownOUTL", "CTRL_expressions_eyelashesDownOUTR", "CTRL_expressions_eyelashesUpINL", "CTRL_expressions_eyelashesUpINR", "CTRL_expressions_eyelashesUpOUTL", "CTRL_expressions_eyelashesUpOUTR", "CTRL_expressions_jawBack", "CTRL_expressions_jawChinCompressL", "CTRL_expressions_jawChinCompressR", "CTRL_expressions_jawChinRaiseDL", "CTRL_expressions_jawChinRaiseDR", "CTRL_expressions_jawChinRaiseUL", "CTRL_expressions_jawChinRaiseUR", "CTRL_expressions_jawClenchL", "CTRL_expressions_jawClenchR", "CTRL_expressions_jawFwd", "CTRL_expressions_jawLeft", "CTRL_expressions_jawOpen", "CTRL_expressions_jawOpenExtreme", "CTRL_expressions_jawRight", "CTRL_expressions_mouthCheekBlowL", "CTRL_expressions_mouthCheekBlowR", "CTRL_expressions_mouthCheekSuckL", "CTRL_expressions_mouthCheekSuckR", "CTRL_expressions_mouthCornerDepressL", "CTRL_expressions_mouthCornerDepressR", "CTRL_expressions_mouthCornerDownL", "CTRL_expressions_mouthCornerDownR", "CTRL_expressions_mouthCornerNarrowL", "CTRL_expressions_mouthCornerNarrowR", "CTRL_expressions_mouthCornerPullL", "CTRL_expressions_mouthCornerPullR", "CTRL_expressions_mouthCornerRounderDL", "CTRL_expressions_mouthCornerRounderDR", "CTRL_expressions_mouthCornerRounderUL", "CTRL_expressions_mouthCornerRounderUR", "CTRL_expressions_mouthCornerSharpenDL", "CTRL_expressions_mouthCornerSharpenDR", "CTRL_expressions_mouthCornerSharpenUL", "CTRL_expressions_mouthCornerSharpenUR", "CTRL_expressions_mouthCornerUpL", "CTRL_expressions_mouthCornerUpR", "CTRL_expressions_mouthCornerWideL", "CTRL_expressions_mouthCornerWideR", "CTRL_expressions_mouthDimpleL", "CTRL_expressions_mouthDimpleR", "CTRL_expressions_mouthDown", "CTRL_expressions_mouthFunnelDL", "CTRL_expressions_mouthFunnelDR", "CTRL_expressions_mouthFunnelUL", "CTRL_expressions_mouthFunnelUR", "CTRL_expressions_mouthLeft", "CTRL_expressions_mouthLipsBlowL", "CTRL_expressions_mouthLipsBlowR", "CTRL_expressions_mouthLipsPressL", "CTRL_expressions_mouthLipsPressR", "CTRL_expressions_mouthLipsPullDL", "CTRL_expressions_mouthLipsPullDR", "CTRL_expressions_mouthLipsPullUL", "CTRL_expressions_mouthLipsPullUR", "CTRL_expressions_mouthLipsPurseDL", "CTRL_expressions_mouthLipsPurseDR", "CTRL_expressions_mouthLipsPurseUL", "CTRL_expressions_mouthLipsPurseUR", "CTRL_expressions_mouthLipsPushDL", "CTRL_expressions_mouthLipsPushDR", "CTRL_expressions_mouthLipsPushUL", "CTRL_expressions_mouthLipsPushUR", "CTRL_expressions_mouthLipsStickyLPh1", "CTRL_expressions_mouthLipsStickyLPh2", "CTRL_expressions_mouthLipsStickyLPh3", "CTRL_expressions_mouthLipsStickyRPh1", "CTRL_expressions_mouthLipsStickyRPh2", "CTRL_expressions_mouthLipsStickyRPh3", "CTRL_expressions_mouthLipsThickDL", "CTRL_expressions_mouthLipsThickDR", "CTRL_expressions_mouthLipsThickInwardDL", "CTRL_expressions_mouthLipsThickInwardDR", "CTRL_expressions_mouthLipsThickInwardUL", "CTRL_expressions_mouthLipsThickInwardUR", "CTRL_expressions_mouthLipsThickUL", "CTRL_expressions_mouthLipsThickUR", "CTRL_expressions_mouthLipsThinDL", "CTRL_expressions_mouthLipsThinDR", "CTRL_expressions_mouthLipsThinInwardDL", "CTRL_expressions_mouthLipsThinInwardDR", "CTRL_expressions_mouthLipsThinInwardUL", "CTRL_expressions_mouthLipsThinInwardUR", "CTRL_expressions_mouthLipsThinUL", "CTRL_expressions_mouthLipsThinUR", "CTRL_expressions_mouthLipsTightenDL", "CTRL_expressions_mouthLipsTightenDR", "CTRL_expressions_mouthLipsTightenUL", "CTRL_expressions_mouthLipsTightenUR", "CTRL_expressions_mouthLipsTogetherDL", "CTRL_expressions_mouthLipsTogetherDR", "CTRL_expressions_mouthLipsTogetherUL", "CTRL_expressions_mouthLipsTogetherUR", "CTRL_expressions_mouthLipsTowardsDL", "CTRL_expressions_mouthLipsTowardsDR", "CTRL_expressions_mouthLipsTowardsUL", "CTRL_expressions_mouthLipsTowardsUR", "CTRL_expressions_mouthLowerLipBiteL", "CTRL_expressions_mouthLowerLipBiteR", "CTRL_expressions_mouthLowerLipDepressL", "CTRL_expressions_mouthLowerLipDepressR", "CTRL_expressions_mouthLowerLipRollInL", "CTRL_expressions_mouthLowerLipRollInR", "CTRL_expressions_mouthLowerLipRollOutL", "CTRL_expressions_mouthLowerLipRollOutR", "CTRL_expressions_mouthLowerLipShiftLeft", "CTRL_expressions_mouthLowerLipShiftRight", "CTRL_expressions_mouthLowerLipTowardsTeethL", "CTRL_expressions_mouthLowerLipTowardsTeethR", "CTRL_expressions_mouthPressDL", "CTRL_expressions_mouthPressDR", "CTRL_expressions_mouthPressUL", "CTRL_expressions_mouthPressUR", "CTRL_expressions_mouthRight", "CTRL_expressions_mouthSharpCornerPullL", "CTRL_expressions_mouthSharpCornerPullR", "CTRL_expressions_mouthStickyDC", "CTRL_expressions_mouthStickyDINL", "CTRL_expressions_mouthStickyDINR", "CTRL_expressions_mouthStickyDOUTL", "CTRL_expressions_mouthStickyDOUTR", "CTRL_expressions_mouthStickyUC", "CTRL_expressions_mouthStickyUINL", "CTRL_expressions_mouthStickyUINR", "CTRL_expressions_mouthStickyUOUTL", "CTRL_expressions_mouthStickyUOUTR", "CTRL_expressions_mouthStretchL", "CTRL_expressions_mouthStretchLipsCloseL", "CTRL_expressions_mouthStretchLipsCloseR", "CTRL_expressions_mouthStretchR", "CTRL_expressions_mouthUp", "CTRL_expressions_mouthUpperLipBiteL", "CTRL_expressions_mouthUpperLipBiteR", "CTRL_expressions_mouthUpperLipRaiseL", "CTRL_expressions_mouthUpperLipRaiseR", "CTRL_expressions_mouthUpperLipRollInL", "CTRL_expressions_mouthUpperLipRollInR", "CTRL_expressions_mouthUpperLipRollOutL", "CTRL_expressions_mouthUpperLipRollOutR", "CTRL_expressions_mouthUpperLipShiftLeft", "CTRL_expressions_mouthUpperLipShiftRight", "CTRL_expressions_mouthUpperLipTowardsTeethL", "CTRL_expressions_mouthUpperLipTowardsTeethR", "CTRL_expressions_neckDigastricDown", "CTRL_expressions_neckDigastricUp", "CTRL_expressions_neckMastoidContractL", "CTRL_expressions_neckMastoidContractR", "CTRL_expressions_neckStretchL", "CTRL_expressions_neckStretchR", "CTRL_expressions_neckSwallowPh1", "CTRL_expressions_neckSwallowPh2", "CTRL_expressions_neckSwallowPh3", "CTRL_expressions_neckSwallowPh4", "CTRL_expressions_neckThroatDown", "CTRL_expressions_neckThroatExhale", "CTRL_expressions_neckThroatInhale", "CTRL_expressions_neckThroatUp", "CTRL_expressions_noseNasolabialDeepenL", "CTRL_expressions_noseNasolabialDeepenR", "CTRL_expressions_noseNostrilCompressL", "CTRL_expressions_noseNostrilCompressR", "CTRL_expressions_noseNostrilDepressL", "CTRL_expressions_noseNostrilDepressR", "CTRL_expressions_noseNostrilDilateL", "CTRL_expressions_noseNostrilDilateR", "CTRL_expressions_noseWrinkleL", "CTRL_expressions_noseWrinkleR", "CTRL_expressions_noseWrinkleUpperL", "CTRL_expressions_noseWrinkleUpperR", "CTRL_expressions_teethBackD", "CTRL_expressions_teethBackU", "CTRL_expressions_teethDownD", "CTRL_expressions_teethDownU", "CTRL_expressions_teethFwdD", "CTRL_expressions_teethFwdU", "CTRL_expressions_teethLeftD", "CTRL_expressions_teethLeftU", "CTRL_expressions_teethRightD", "CTRL_expressions_teethRightU", "CTRL_expressions_teethUpD", "CTRL_expressions_teethUpU", "CTRL_expressions_tongueBendDown", "CTRL_expressions_tongueBendUp", "CTRL_expressions_tongueDown", "CTRL_expressions_tongueIn", "CTRL_expressions_tongueLeft", "CTRL_expressions_tongueNarrow", "CTRL_expressions_舌头伸出", "CTRL_expressions_舌头顶压", "CTRL_expressions_舌头向右", "CTRL_expressions_舌头卷起", "CTRL_expressions_舌头变厚", "CTRL_expressions_舌头变薄", "CTRL_expressions_舌尖向下", "CTRL_expressions_舌尖向左", "CTRL_expressions_舌尖向右", "CTRL_expressions_舌尖向上", "CTRL_expressions_舌头向左扭转", "CTRL_expressions_舌头向右扭转", "CTRL_expressions_舌头向上", "CTRL_expressions_舌头张宽" ] ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk/vanilla-typescript/mappings-reference.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.