如何在RealityKit中为USDZ 3D角色实现多段动画切换（idle、行走、跳跃等）

以下是实现角色idle（待机）、行走、跳跃等状态对应动画的具体步骤：

1. 准备包含多段动画的USDZ资源 #

首先确保你的USDZ文件内置了所需的独立动画片段（idle、walk、jump等）。如果是多个单动画USDZ文件，可以用苹果的usdzconvert命令行工具合并：

usdzconvert idle.usdz walk.usdz jump.usdz --output character_with_animations.usdz

（注：Blender、Maya等3D工具导出时，也可直接将多个动画片段打包进同一个USDZ）

2. 加载角色实体与动画资源 #

在代码中加载角色，并提取或加载对应的动画片段：

import RealityKit

// 加载角色实体
guard let character = try? Entity.load(named: "character_with_animations") else {
    fatalError("Failed to load character USDZ")
}

// 从实体中提取目标动画（名称需和USDZ内的动画名完全一致）
guard let idleAnim = character.availableAnimations.first(where: { $0.name == "idle" }),
      let walkAnim = character.availableAnimations.first(where: { $0.name == "walk" }),
      let jumpAnim = character.availableAnimations.first(where: { $0.name == "jump" }) else {
    fatalError("Missing required animations in USDZ")
}

3. 定义状态管理枚举 #

用枚举统一管理角色状态，避免逻辑混乱：

enum CharacterState {
    case idle, walking, jumping
}

// 跟踪当前状态和动画播放控制器
var currentState: CharacterState = .idle
var currentAnimationPlayback: AnimationPlaybackController?

4. 核心动画切换逻辑 #

实现状态切换方法，处理动画的停止、过渡和循环设置：

func switchToState(_ newState: CharacterState) {
    // 跳过重复状态切换
    guard currentState != newState else { return }
    currentState = newState
    
    // 停止当前正在播放的动画
    currentAnimationPlayback?.stop()
    
    // 根据新状态播放对应动画
    switch newState {
    case .idle:
        currentAnimationPlayback = character.playAnimation(
            idleAnim,
            transitionDuration: 0.2,  // 平滑过渡时长
            startsPaused: false,
            loopMode: .repeat         // 待机动画循环播放
        )
    case .walking:
        currentAnimationPlayback = character.playAnimation(
            walkAnim,
            transitionDuration: 0.2,
            startsPaused: false,
            loopMode: .repeat
        )
    case .jumping:
        currentAnimationPlayback = character.playAnimation(
            jumpAnim,
            transitionDuration: 0.1,  // 跳跃动画快速过渡
            startsPaused: false,
            loopMode: .playOnce       // 跳跃动画只播放一次
        )
        // 跳跃结束后自动切回待机状态（需匹配动画实际时长）
        DispatchQueue.main.asyncAfter(deadline: .now() + jumpAnim.duration) {
            if self.currentState == .jumping {
                self.switchToState(.idle)
            }
        }
    }
}

5. 触发状态切换示例 #

根据业务逻辑调用状态切换方法即可：

// 触发行走状态
switchToState(.walking)

// 触发跳跃状态
switchToState(.jumping)

// 停止行走，切回待机
switchToState(.idle)

关键注意事项 #

• 确保USDZ内的动画名称和代码中完全匹配，否则会提取不到动画；
• 调整transitionDuration可以让动画切换更自然，避免生硬跳帧；
• 复杂场景下（比如行走中触发跳跃），可修改逻辑让跳跃动画优先播放，结束后回到之前的状态；
• 如果动画播放卡顿，尝试优化USDZ的多边形面数或动画关键帧数量。

内容的提问来源于stack exchange，提问作者jeremyjoron