默认动画图谱#

默认动画图谱公开四个动画图谱变量:posture_stategesture_statefacial_gesture_stateposition_state。始终有一个活跃的姿势,而手势运行有限的时长,然后回退到最后设置的姿势。

Illustration of the layering of the various animation types. Some animation states replace, and others combine with each other.

各种动画类型分层的图示。一些动画状态会替换,而另一些则会相互结合。#

可用的姿势、手势、面部表情和位置过渡动画在下表中进行了说明。这些动画通过相应的动画图谱变量进行控制,而这些变量又可以通过 HTTP API 进行控制。

posture_state 变量#

姿势是与恒定头像状态相关联的一组动画。它会持续播放,直到触发不同的姿势。

这是一个设置新姿势的 API 调用示例。有关更多信息,请参阅 HTTP API 部分。

curl -X PUT -s http://127.0.0.1:8020/streams/$stream_id/animation_graphs/avatar/variables/posture_state/Talking
posture_state 变量可以采用此表中显示的任何 Animation ID 值。#

动画 ID

描述

默认

闲置

头像处于闲置状态,四处张望,不看向摄像头。

聆听

头像向前倾斜,靠近摄像头,双手张开放在身体两侧,并不时点头,看向摄像头。

说话

头像像在对话中一样用手势示意。手势生动但中性,看向摄像头。

专注

头像以轻微的摇摆和偶尔短暂地看向摄像头的动作进行最小程度的移动。

x

思考

头像四处张望,仿佛在回忆某事或解决问题。不安地在原地移动并向空中比划手势。不看向摄像头

gesture_state 变量#

手势是瞬间动画,它会播放然后返回到当前姿势。

这是一个设置新手势的 API 调用示例。有关更多信息,请参阅 HTTP API 部分。

curl -X PUT -s http://127.0.0.1:8020/streams/$stream_id/animation_graphs/avatar/variables/gesture_state/Pulling_Mime
gesture_state 变量可以采用此表中显示的任何 Animation ID 值。#

动画 ID

描述

时长

含义

通过将动画图谱变量设置为“无”,您可以中断正在进行的手势。

不适用

不适用

No_1

摇头:头像缓慢摇头。

3 秒

表达强烈的不同意或失望。

Bowing_1

鞠躬:稍微向前鞠躬,同时用双臂做出邀请手势。

2.5 秒

正式问候,表示尊重或祝贺或自豪。

Bowing_2

鞠躬:稍微鞠躬,双臂张开,并用右臂做出邀请手势。

2.5 秒

过度正式的问候,表示尊重或盛大的介绍。

Pointing_To_User_1

指向用户:用双臂指向用户。

2.5 秒

鼓励用户采取行动、靠近或说些什么,或指出用户正在被提及。

Pointing_To_User_2

指向用户:用右臂坚持地指向用户。

3 秒

指责或强烈信号表明用户感到担忧。

Pointing_Down_1

向下指:抬起右臂至肩膀并指向下方。

3 秒

引起对屏幕下方或头像前方某物的注意。

Pointing_Down_2

向下指:抬起双臂并稍微向下指。

2 秒

引起对桌子、屏幕下方或头像前方某物的注意。或告知位置信息。

Pointing_Left_1

向左指:用双臂指向头像的左侧。

4 秒

以命令式的语气指出头像左侧的某物,或表示沮丧。

Pointing_Left_2

向左指:用左臂指向头像的后方左侧。

4 秒

冷静地指出或展示头像左侧的某物。或提供关于头像后方某物的信息。

Pointing_Backward_1

指向后方:用伸直的右臂指向后方。

3.5 秒

告知关于后方方向的某物,或给出关于头像后方某物的方向。

Fistbump_Offer

碰拳:用右手疑问地示意 3 秒,然后向用户方向碰拳 7 秒。

10 秒

邀请碰拳,然后进行碰拳。

Pulling_Mime

拉绳子:头像抓住隐形的绳子并模仿拉扯行为。

3.5 秒

暗示被束缚或被锁链锁住,或拉扯某物。

Raise_Both_Arms

举起双臂:将双臂举过头像头部并稍微摇摆。

3.5 秒

暗示在人群中庆祝,或在过山车上,或表明身上没有任何东西。

The_Robot

机器人舞:模仿跳舞的机器人,手臂以机械运动的方式移动。

3 秒

开玩笑地扮演机器人或跳舞庆祝或表现傻气。

Phone_Dialing

拨打电话:举起左手并模仿用右手拨打电话。

3.5 秒

询问或提及电话号码,或谈论给某人打电话。

Attraction_1

挥手:先用左臂挥手,然后用右臂挥手,然后用双臂挥手。然后指向用户,示意他们靠近。然后模仿钓鱼竿将用户拉近并大笑。然后再次挥手和示意。

25 秒

一系列长的手势,俏皮地鼓励某人靠近头像。

Attraction_2

玩乐:疑问地张开双臂,然后将它们举过头顶,模仿乘坐过山车。

10 秒

傻气,建议玩乐。

Please_Repeat_1

请重复:头部稍微转向用户,并用右臂做圆周运动,然后稍微耸肩。

5.5 秒

暗示没有理解某事,要求重复或改述,或需要更多信息。

Please_Repeat_2

展示:旋转双手并用身体做出邀请姿势。

3.5 秒

要求重复或改述某事,或需要更多信息,或询问是否理解了某事。

Trying_To_See

试图看清:将左手抬到眼睛上方并做手势以便看得更清楚,然后耸肩。

4 秒

暗示在寻找但看不到某物。

Driving_Mime

驾驶:用双手抓住隐形方向盘,转动方向盘并换挡。

4.5 秒

分享关于驾驶的故事或对汽车感到兴奋。

Exhausted

疲惫:头部垂下,呈疲惫姿势,略微倾斜。

4.5 秒

戏剧性地表示精疲力竭或耗尽能量,缓慢关闭。

Presenting_Options_1

展示选项:展示双手张开的手掌,并用右手做出展示动作,稍微耸肩。

3.5 秒

提供概述或多个选项供选择。

Presenting_Options_2

展示选项:依次抬起并张开一只手,并做出细微的耸肩动作。

3 秒

建议在两个选项之间做出选择。

Open_Question_1

开放式问题:张开双手并向用户展示手掌。

3 秒

等待用户做出选择、回答问题或说些什么。

Personal_Statement_1

个人陈述:将右手抬到胸前,伸出左手并做手势。

3.5 秒

发表个人陈述,解释关于他们自己的某事或提出与左侧某物相关的建议。

Success_1

成功:握紧拳头并将手臂以成功的挥舞动作抬起。

2 秒

滑稽地庆祝某事进展顺利,对个人成就感到自豪。

Dont_Understand_1

不理解:将双手抬到头部旁边并做圆周运动。

3 秒

暗示感到困惑、不知所措或愚蠢。

Toss

抛掷:模仿用双手形成一个球并将其向前抛掷。

4 秒

暗示将某物揉成一团并扔掉,放弃某物或忘记它。

Come_Here_1

过来:伸出双臂并弯曲食指。

2 秒

要求靠近。

Tell_Secret

讲秘密:靠近用户并在嘴边用手小声说话。

2.5 秒

分享亲密的、秘密的或煽动性的事物,或提供提示。

Goodbye

挥手告别:高高举起左手挥手。

2 秒

从较远的距离与某人道别,或引起某人的注意。

Welcome

挥手问好:稍微张开双臂,然后将右手抬到脸旁并张开手挥手。

2.5 秒。

以害羞或可爱的姿态问候某人,表现出积极且无威胁的态度。

Personal_Statement_2

个人陈述:向前倾斜,用放松的右手指向自己,然后向后倾斜,张开双臂,手掌朝上。

3 秒

以夸张的手势揭示关于他们自己的某事,或对他们的外貌或个性开个小玩笑。

Pointing_To_Self_1

指向自己:稍微向前倾斜,并用放松的右食指指向自己。

2.5 秒

说一些关于他们自己的事情。

Stupid_1

愚蠢:将右手抬到头部旁边并用食指画圈。

3.5 秒。

手势暗示某人或某物可能很疯狂或愚蠢。

Pointing_Right_1

向右指:用双臂指向头像的右侧。

4 秒

以命令式的语气指出头像右侧的某物,或表示沮丧。

Pointing_Right_2

向右指:用右臂指向头像的后方右侧。

4 秒

冷静地指出或展示头像右侧的某物。或提供关于头像后方某物的信息。

Chefs_Kiss

厨师之吻:头像做出亲吻手势,并举起右手,食指和拇指接触。

1.7 秒

暗示某事非常完美。某事的结果比预期的要好。来自教学或评判职位的人的认可。

Finger_Guns

手枪:向后倾斜,用两根食指指向用户,模仿牛仔的两把枪。

3 秒

俏皮地嘲讽。幽默地强调一个糟糕的笑话。笨拙地调情。

Finger_Wag

摇手指:向后拉,摇头,并举起摇摆的右食指

1.7 秒

在被误解后纠正。向对方表明他们误解了所说的话。暗示某事是被禁止的或不适当的,以一种家长式或俏皮的方式。

Little

小:向前倾斜,眯着眼睛看着抬起的右手,食指和拇指紧靠在一起。

1.8 秒

将某物描述为非常小或微小的。某物在物理上很小,或者问题微不足道以至于可以忽略不计。

Money

金钱:抬起右手,拇指和食指互相摩擦。

2 秒

暗示某物很昂贵。有人很富有。做某事需要付款。

Number_1a

数字 1:抬起右手并伸出食指。

1.4 秒

展示数字 1

Number_2a

数字 2:抬起右手并伸出食指和中指。

1.4 秒

展示数字 2

Number_3a

数字 3:抬起右手并伸出食指、中指和无名指。

1.4 秒

展示数字 3

Number_4a

数字 4:抬起右手并伸出除拇指外的所有手指。

1.4 秒

展示数字 4

Number_5a

数字 5:抬起右手并伸出所有手指。

1.4 秒

展示数字 5

Number_1b

数字 1(德式):抬起右手并向上伸出拇指。

1.4 秒

为日耳曼观众展示数字 1

Number_2b

数字 2(德式):抬起右手并伸出拇指和食指。

1.4 秒

为日耳曼观众展示数字 2

Number_3b

数字 3(德式):抬起右手并伸出拇指、食指和中指。

1.4 秒

为日耳曼观众展示数字 3

Number_6c

数字 6(中式):抬起右手并伸出拇指和小指。

1.4 秒

为中国观众展示数字 6

Number_7c

数字 7(中式):抬起右手并做出爪状,拇指接触手指。

1.4 秒

为中国观众展示数字 7

Number_8c

数字 8(中式):抬起右手并伸出食指和拇指,稍微指向侧面。

1.4 秒

为中国观众展示数字 8

Number_9c

数字 9(中式):抬起右手并举起弯曲的食指。

1.4 秒

为中国观众展示数字 9

Ouch

哎哟:跳起来并在转开头的同事畏缩,然后快速恢复,甩动右手并呼气。

2 秒

险些避开危险的时刻。瞬间感到强烈的恐惧,然后是精疲力竭或解脱。也可以是对他人困境的反应。或对恰到好处的侮辱的回应。

Angry_Shaking_Fist

愤怒地挥舞拳头:靠近,低下头并向前挥舞右拳。

1.6 秒

愤怒地感到沮丧。发誓报仇或威胁暴力。

Pointing_To_Self_Questioningly

疑问地指向自己:犹豫地抬起右指,转头并指向自己,同时稍微向后倾斜。

2.8 秒

询问某事是否指的是他们,不确定他们是否被提及。询问某事是否适合他们,或者他们是否可以做某事。

Pointing_To_User_Questioningly

疑问地指向用户:抬起右指指向用户,最初有些犹豫,同时稍微向后倾斜。

2.4 秒

询问某事是否可能与用户有关,或者用户是否对报价感兴趣。暗示用户可能是某事的合适人选。不确定用户的参与程度。

Raise_Finger_Big

大幅度举起手指:以大幅度的扫动动作举起右食指,然后用它短暂地示意。

2.5 秒

做出一个令人惊讶的重大宣布。非常自负或迂腐,兴高采烈地纠正某人。

More_Or_Less

或多或少:向前倾斜并伸出一只手掌朝下的平手,来回摆动手。

1.8 秒

解释某事不太准确,是未知的,或者只是猜测。相对化先前的陈述。犹豫不决,不采取明确的立场。指出某事的复杂性。

Thumbs_Up

竖起大拇指:抬起右手,拇指向上伸出。

1.4 秒

表示赞同。某事是正确的。热情地同意所说的话并表示支持。一切都很好,没有造成伤害。鼓励继续前进。

Thumbs_Down

拇指向下:抬起右手,拇指向下指。

1.4 秒

表示不赞同。某事是错误的。粗鲁地不同意所说的话,表示拒绝。

facial_gesture_state 变量#

面部表情是瞬间的面部动画,它会播放然后返回到活动姿势的当前面部动画。

这是一个触发面部表情的 API 调用示例。有关更多信息,请参阅 HTTP API 部分。

curl -X PUT -s http://127.0.0.1:8020/streams/$stream_id/animation_graphs/avatar/variables/facial_gesture_state/Smile
facial_gesture_state 变量可以采用此表中显示的任何 Animation ID 值。#

动画 ID

描述

时长

含义

Angry

生气:皱眉,用愤怒的皱眉短暂地瞪着用户。

1.7 秒

表达愤怒、不满、被侮辱或痛苦。

Angry_Intense

非常生气:皱眉,低下头,愤怒地露出牙齿。

2.3 秒

表达愤怒或仇恨,怀恨在心或对抗。

Astonishment

惊讶:头部向前倾斜并张开下巴。

2.7 秒

表达惊讶,印象深刻且说不出话来。

Confused

困惑:稍微眯眼并张开嘴。

1.8 秒

表达困惑。无法理解所说的话。

Confused_Intense

非常困惑:头部向前倾斜,歪着嘴并略微冷笑。

2 秒

表达完全困惑。某事完全没有意义。

Disgust

厌恶:鼻子皱起,嘴唇卷曲,头部向后拉。

1.5 秒

表达厌恶。发现某事令人反感或非常消极的惊喜。

Disgust_Intense

非常厌恶:冷笑,向后拉,摇头,卷曲嘴唇,露出牙齿。

2.5 秒

表达反感。发现某事极其恶心或冒犯。

Doubtful

怀疑:眯着眼睛,一只眼睛稍微多一点冷笑。

1.7 秒

表达怀疑。不确定某事是否可能是真的。可能存在误解。

Doubtful_Intense

非常怀疑:倾斜头部,强烈地歪着嘴并用力眯眼。

1.7 秒

表达不相信。某事不可能正确。肯定有错误。

Excited

兴奋:头部向前倾斜,张开嘴大笑。

3 秒

表达说不出话的兴奋,非常积极的惊喜或快乐。

Eye_Roll

翻白眼:向上看并看向侧面,稍微转开头。

2.5 秒

表达对愚蠢或乏味的事情感到恼火。

Eye_Roll_Intense

大翻白眼:向上和向侧面翻白眼和头部,嘴巴稍微张开。

2.5 秒

表达对某事感到非常恼火或沮丧。

Pensive

沉思:稍微向下看并看向侧面,皱着眉头。

2 秒

表达必须思考某事。不确定或想知道。

Pensive_Intense

非常沉思:看向侧面并倾斜头部,皱着眉头,嘴唇紧绷。

2.5 秒

表达紧张的思考或犹豫不决。

Sad

悲伤:低下头,皱着眉头看着地面。

4 秒

表达悲伤。感到情感上的伤害或失望。

Sad_Intense

非常悲伤:垂着头,看着地面,深深地皱着眉头,嘴唇颤抖。

4 秒

表达极度悲伤。濒临崩溃。深受伤害和不知所措。

Shrug

耸肩:打破眼神交流,倾斜头部并在轻微皱眉中抬起嘴唇。

1.4 秒

表达不确定或不感兴趣。不知道某事而不在意。

Shrug_Intense

大耸肩:看向别处,抬起并倾斜头部,歪着嘴并皱眉。

1.3 秒

表达不知道。轻率。

Smile

微笑:闭着嘴唇微笑。

2 秒

表达快乐、高兴或只是礼貌。

Smile_Intense

大笑:咧嘴笑。

2.8 秒

表达非常高兴和快乐。礼貌的问候。也可能是讽刺。

Surprised

惊讶:睁大眼睛,嘴唇微张,抬起头。

2 秒

表达惊讶。被某事措手不及。

Surprised_Intense

非常惊讶:张开嘴,头部略微颤抖,眼睛睁大,眉毛抬起。

2 秒

表达震惊。惊讶到恐惧的地步。

Taunt

嘲讽:挑起眉毛,将头转向一侧,露出单侧微笑。

1.2 秒

表达愉快的挑衅。厚脸皮,暗示某事或调情。

Taunt_Intense

过度嘲讽:微笑,将头转向侧面,进行眼神交流并弹动眉毛。

2 秒

表达强烈的暗示。以一种俏皮的方式嘲讽和建议某事。

Tired

疲倦:缓慢眨眼,降低下巴,眼睛半睁。

4 秒

表达疲倦。某事非常累人或无聊。

Tired_Intense

非常疲倦:头部下沉,眼睛短暂闭合,然后突然醒来并恢复。

2.5 秒

表达极度疲倦。睡着了一秒钟。

Wink

眨眼:微微一笑,头部倾斜,用左眼短暂地眨眼。

0.8 秒

表达暗示。暗示某事不应被认真对待。只是开玩笑。

Wink_Intense

大眨眼:转头,用左眼眨眼并微微一笑。

1 秒

表达俏皮。做出明显的暗示,提供交易,或变得下流。

Yawn

打哈欠:闭上眼睛,张开嘴并拉紧脸部,向后拉下巴。

1.8 秒

表达无聊。通常感到疲倦、无事可做或不活跃。非自愿发生。

Sneaky

偷偷摸摸:稍微转头,并得意地笑。

1.5 秒

表达狡猾或沾沾自喜。提出挑战,展现骄傲和自信或恶作剧。

Sneaky_Intense

非常偷偷摸摸:低下头,冷眼笑着,眼睛在房间里扫视。

2.1 秒

表达狡猾。计划一些邪恶的事情,进行操纵或享受他人的危险。令人毛骨悚然或阴森恐怖,试图灌输恐惧。

Head_Shake_Big

大幅摇头:用力摇头两次。

1.6 秒

表达清晰、果断的不同意

Head_Shake_Frantic

疯狂摇头:闭上眼睛并快速摇头三次。

1.8 秒

表达强调的不同意。暗示某事被误解了。

Head_Shake_Slowly

缓慢摇头:缓慢摇头两次

1.9 秒

表达犹豫的不同意。某事可能出错了。

Nodding_Big

大幅点头:睁大眼睛用力点头一次。

2 秒

表达清晰、果断的同意

Nodding_Frantic

疯狂点头:快速点头四次。

1.6 秒

表达强调的、支持性的同意。

Nodding_Slowly

缓慢点头:缓慢点头三次。

3 秒

表达富有同情心、耐心的同意。

Nodding_Upward

向上点头:用下巴向上点头并抬起眉毛。

0.8 秒

含蓄的问候或识别标志。称呼某人。

position_state 变量#

位置定义了角色在空间中的位置。当此状态更改时,它会触发一个动画,该动画会移动角色的根关节。根关节的特殊之处在于,在动画结束后,它不会重置为其原始位置。因此,即使在过渡回姿势动画之后,角色仍会停留在其新位置。

这是一个更改头像位置的 API 调用示例。有关更多信息,请参阅 HTTP API 部分。

curl -X PUT -s http://127.0.0.1:8020/streams/$stream_id/animation_graphs/avatar/variables/position_state/Left
position_state 变量可以采用此表中显示的任何 Animation ID 值。#

动画 ID

描述

头像站在场景的右侧(从头像的角度看)。

中心

头像站在场景的中心。

头像站在场景的左侧(从头像的角度看)。

Audio2Face 动画#

Audio2Face 混合形状数据由动画图谱中的姿势提供程序节点接收,然后以与面部表情几乎相同的方式与动画的其余部分进行加法混合。