> 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, and the optional `goal` 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=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.