002 《O3DE游戏开发权威指南：Android、Windows、iOS跨平台实战》

                                
                                    

                            
1
                            
export PATH="$PATH:/Applications/o3de-launcher/o3de/23.10.0/bin" # 将路径替换为你的 O3DE 引擎安装路径
                        
                                
                            

                                
                                    

                            
1
                            
chmod +x O3DE-Launcher-*.AppImage # 将文件名替换为你的安装包文件名
                        
                                
                            

                                
                                    

                            
1
                            
./O3DE-Launcher-*.AppImage # 将文件名替换为你的安装包文件名
                        
                                
                            

                                
                                    

                            
1
                            
export PATH="$PATH:$HOME/o3de/23.10.0/bin" # 将路径替换为你的 O3DE 引擎安装路径
                        
                                
                            

                                
                                    

                            
1
                            
#pragma once
                        

                            
2
                            

                        

                            
3
                            
#include <AzCore/Component/Component.h>
                        

                            
4
                            
#include <AzCore/Serialization/SerializeContext.h>
                        

                            
5
                            
#include <AzCore/RTTI/RTTI.h>
                        

                            
6
                            
#include <AzCore/Math/Vector3.h>
                        

                            
7
                            
#include <AzCore/Math/Quaternion.h>
                        

                            
8
                            
#include <AzFramework/Components/TransformComponentBus.h>
                        

                            
9
                            

                        

                            
10
                            
namespace O3DEBook
                        

                            
11
                            
{
                        

                            
12
                            
    class RotateComponent final : public AZ::Component
                        

                            
13
                            
    {
                        

                            
14
                            
    public:
                        

                            
15
                            
        AZ_COMPONENT(RotateComponent, "{YOUR-UNIQUE-UUID-HERE}"); // 替换为你的Gem的UUID
                        

                            
16
                            

                        

                            
17
                            
        static void Reflect(AZ::ReflectContext* context);
                        

                            
18
                            

                        

                            
19
                            
        RotateComponent();
                        

                            
20
                            
        ~RotateComponent() override = default;
                        

                            
21
                            

                        

                            
22
                            
    protected:
                        

                            
23
                            
        void Activate() override;
                        

                            
24
                            
        void Deactivate() override;
                        

                            
25
                            

                        

                            
26
                            
    private:
                        

                            
27
                            
        float m_rotationSpeedDegreesPerSecond = 45.0f; // 旋转速度，度/秒
                        

                            
28
                            
    };
                        

                            
29
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
#include "RotateComponent.h"
                        

                            
2
                            

                        

                            
3
                            
#include <AzCore/Serialization/EditContext.h>
                        

                            
4
                            

                        

                            
5
                            
namespace O3DEBook
                        

                            
6
                            
{
                        

                            
7
                            
    void RotateComponent::Reflect(AZ::ReflectContext* context)
                        

                            
8
                            
    {
                        

                            
9
                            
        if (AZ::SerializeContext* serializeContext = azrtti_cast<AZ::SerializeContext*>(context))
                        

                            
10
                            
        {
                        

                            
11
                            
            serializeContext->Class<RotateComponent, AZ::Component>()
                        

                            
12
                            
                ->Version(1)
                        

                            
13
                            
                ->Field("RotationSpeed", &RotateComponent::m_rotationSpeedDegreesPerSecond)
                        

                            
14
                            
            ;
                        

                            
15
                            

                        

                            
16
                            
            if (AZ::EditContext* editContext = serializeContext->GetEditContext())
                        

                            
17
                            
            {
                        

                            
18
                            
                editContext->Class<RotateComponent>("Rotate Component", "Rotates the entity")
                        

                            
19
                            
                    ->ClassElement(AZ::Edit::ClassElements::EditorData, "")
                        

                            
20
                            
                        ->Attribute(AZ::Edit::Attributes::AutoExpand, true)
                        

                            
21
                            
                    ->DataElement(AZ::Edit::UIHandlers::Default, &RotateComponent::m_rotationSpeedDegreesPerSecond, "Rotation Speed (Degrees/Second)", "Speed at which the entity rotates around the Y-axis.")
                        

                            
22
                            
                        ->Attribute(AZ::Edit::Attributes::Min, 0.0f)
                        

                            
23
                            
                        ->Attribute(AZ::Edit::Attributes::Max, 360.0f)
                        

                            
24
                            
                ;
                        

                            
25
                            
            }
                        

                            
26
                            
        }
                        

                            
27
                            
    }
                        

                            
28
                            

                        

                            
29
                            
    RotateComponent::RotateComponent()
                        

                            
30
                            
        : m_rotationSpeedDegreesPerSecond(45.0f)
                        

                            
31
                            
    {
                        

                            
32
                            
    }
                        

                            
33
                            

                        

                            
34
                            
    void RotateComponent::Activate()
                        

                            
35
                            
    {
                        

                            
36
                            
        // 组件激活时的逻辑，例如注册Tick事件
                        

                            
37
                            
        AZ::TickBus::Get()->QueueForTick(this);
                        

                            
38
                            
    }
                        

                            
39
                            

                        

                            
40
                            
    void RotateComponent::Deactivate()
                        

                            
41
                            
    {
                        

                            
42
                            
        // 组件停用时的逻辑，例如取消注册Tick事件
                        

                            
43
                            
        AZ::TickBus::Get()->UnqueueFromTick(this);
                        

                            
44
                            
    }
                        

                            
45
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
#pragma once
                        

                            
2
                            

                        

                            
3
                            
// ... (之前的头文件内容) ...
                        

                            
4
                            
#include <AzCore/System/Tick.h>
                        

                            
5
                            

                        

                            
6
                            
namespace O3DEBook
                        

                            
7
                            
{
                        

                            
8
                            
    class RotateComponent final : public AZ::Component
                        

                            
9
                            
        , public AZ::TickBus::Handler // 继承 TickBus Handler
                        

                            
10
                            
    {
                        

                            
11
                            
    public:
                        

                            
12
                            
        // ... (之前的公共成员) ...
                        

                            
13
                            

                        

                            
14
                            
    protected:
                        

                            
15
                            
        // ... (之前的保护成员) ...
                        

                            
16
                            

                        

                            
17
                            
    private:
                        

                            
18
                            
        // ... (之前的私有成员) ...
                        

                            
19
                            
        void OnTick(float deltaTime, AZ::TickBus::TickType tickType) override; // Tick 函数
                        

                            
20
                            
    };
                        

                            
21
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
#include "RotateComponent.h"
                        

                            
2
                            

                        

                            
3
                            
// ... (之前的 cpp 文件内容) ...
                        

                            
4
                            
#include <AzCore/Time/Timer.h>
                        

                            
5
                            

                        

                            
6
                            
namespace O3DEBook
                        

                            
7
                            
{
                        

                            
8
                            
    // ... (Reflect, 构造函数, Activate, Deactivate 函数) ...
                        

                            
9
                            

                        

                            
10
                            
    void RotateComponent::OnTick(float deltaTime, AZ::TickBus::TickType tickType)
                        

                            
11
                            
    {
                        

                            
12
                            
        // 获取TransformComponent，如果不存在则返回
                        

                            
13
                            
        AZ::TransformComponentInterface* transform = AZ::Interface<AZ::TransformComponentInterface>::Get();
                        

                            
14
                            
        if (!transform)
                        

                            
15
                            
        {
                        

                            
16
                            
            return;
                        

                            
17
                            
        }
                        

                            
18
                            

                        

                            
19
                            
        // 获取当前实体的TransformComponent
                        

                            
20
                            
        AZ::Transform transformInterface = transform->GetTransform(GetEntityId());
                        

                            
21
                            

                        

                            
22
                            
        if (!transformInterface.IsValid())
                        

                            
23
                            
        {
                        

                            
24
                            
            return; // 实体没有TransformComponent，直接返回
                        

                            
25
                            
        }
                        

                            
26
                            

                        

                            
27
                            
        // 计算旋转角度增量
                        

                            
28
                            
        float rotationAngleDegrees = m_rotationSpeedDegreesPerSecond * deltaTime;
                        

                            
29
                            
        AZ::Quaternion rotationIncrement = AZ::Quaternion::CreateRotationY(AZ::DegToRad(rotationAngleDegrees));
                        

                            
30
                            

                        

                            
31
                            
        // 获取当前旋转
                        

                            
32
                            
        AZ::Quaternion currentRotation = transformInterface.GetRotation();
                        

                            
33
                            

                        

                            
34
                            
        // 计算新的旋转
                        

                            
35
                            
        AZ::Quaternion newRotation = currentRotation * rotationIncrement;
                        

                            
36
                            

                        

                            
37
                            
        // 设置新的旋转
                        

                            
38
                            
        transformInterface.SetRotation(newRotation);
                        

                            
39
                            
    }
                        

                            
40
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
class MyClass
                        

                            
2
                            
{
                        

                            
3
                            
    AZ_TYPE_INFO(MyClass, "{YOUR-UNIQUE-UUID-HERE}");
                        

                            
4
                            
    // ... 类定义 ...
                        

                            
5
                            
};
                        
                                
                            

                                
                                    

                            
1
                            
class MyComponent : public AZ::Component
                        

                            
2
                            
{
                        

                            
3
                            
    AZ_CLASS_BEGIN(MyComponent, AZ::Component);
                        

                            
4
                            
        // ... 反射注册 ...
                        

                            
5
                            
    AZ_CLASS_END();
                        

                            
6
                            
    // ... 类定义 ...
                        

                            
7
                            
};
                        
                                
                            

                                
                                    

                            
1
                            
class MyComponent : public AZ::Component
                        

                            
2
                            
{
                        

                            
3
                            
    AZ_CLASS_BEGIN(MyComponent, AZ::Component);
                        

                            
4
                            
        AZ_FIELD("Speed", m_speed);
                        

                            
5
                            
    AZ_CLASS_END();
                        

                            
6
                            

                        

                            
7
                            
private:
                        

                            
8
                            
    float m_speed = 1.0f;
                        

                            
9
                            
};
                        
                                
                            

                                
                                    

                            
1
                            
class MyComponent : public AZ::Component
                        

                            
2
                            
{
                        

                            
3
                            
    AZ_CLASS_BEGIN(MyComponent, AZ::Component);
                        

                            
4
                            
        AZ_METHOD(DoSomething);
                        

                            
5
                            
    AZ_CLASS_END();
                        

                            
6
                            

                        

                            
7
                            
public:
                        

                            
8
                            
    void DoSomething() { /* ... 方法实现 ... */ }
                        

                            
9
                            
};
                        
                                
                            

                                
                                    

                            
1
                            
enum class MyEnum
                        

                            
2
                            
{
                        

                            
3
                            
    Value1,
                        

                            
4
                            
    Value2,
                        

                            
5
                            
    Value3
                        

                            
6
                            
};
                        

                            
7
                            
AZ_ENUM_BEGIN(MyEnum);
                        

                            
8
                            
    AZ_ENUM_VALUE(Value1);
                        

                            
9
                            
    AZ_ENUM_VALUE(Value2);
                        

                            
10
                            
    AZ_ENUM_VALUE(Value3);
                        

                            
11
                            
AZ_ENUM_END();
                        
                                
                            

                                
                                    

                            
1
                            
#pragma once
                        

                            
2
                            

                        

                            
3
                            
#include <AzCore/EBus/EBus.h>
                        

                            
4
                            
#include <AzCore/Component/ComponentBus.h>
                        

                            
5
                            

                        

                            
6
                            
namespace O3DEBook
                        

                            
7
                            
{
                        

                            
8
                            
    // EBus 接口定义
                        

                            
9
                            
    class RotateComponentNotificationBus : public AZ::EBusTraits
                        

                            
10
                            
    {
                        

                            
11
                            
    public:
                        

                            
12
                            
        // EBusTraits 定义
                        

                            
13
                            
        using BusIdType = AZ::EntityId; // 使用 EntityId 作为 BusIdType
                        

                            
14
                            
        using HandlerType = RotateComponentNotificationBus::Handler;
                        

                            
15
                            

                        

                            
16
                            
        // 事件函数
                        

                            
17
                            
        virtual void OnRotationSpeedChanged(float newSpeed) = 0;
                        

                            
18
                            

                        

                            
19
                            
        // Handler 类，用于组件继承和实现事件处理函数
                        

                            
20
                            
        class Handler : public AZ::EBusHandlerMixin<RotateComponentNotificationBus>
                        

                            
21
                            
        {
                        

                            
22
                            
        public:
                        

                            
23
                            
            // 默认实现，可以被组件重写
                        

                            
24
                            
            virtual void OnRotationSpeedChanged(float newSpeed) override {}
                        

                            
25
                            
        };
                        

                            
26
                            
    };
                        

                            
27
                            

                        

                            
28
                            
    // 定义 EBus 连接器，方便组件连接到 EBus
                        

                            
29
                            
    using RotateComponentNotificationBusPtr = AZ::EBusPtr<RotateComponentNotificationBus>;
                        

                            
30
                            
    using RotateComponentNotificationBusBroadcast = AZ::EBusBroadcast<RotateComponentNotificationBus>;
                        

                            
31
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
#include "RotateComponent.h"
                        

                            
2
                            
#include "RotateComponentNotificationBus.h" // 引入 EBus 接口头文件
                        

                            
3
                            

                        

                            
4
                            
namespace O3DEBook
                        

                            
5
                            
{
                        

                            
6
                            
    // ... (RotateComponent 类定义) ...
                        

                            
7
                            

                        

                            
8
                            
    void RotateComponent::Reflect(AZ::ReflectContext* context)
                        

                            
9
                            
    {
                        

                            
10
                            
        if (AZ::SerializeContext* serializeContext = azrtti_cast<AZ::SerializeContext*>(context))
                        

                            
11
                            
        {
                        

                            
12
                            
            serializeContext->Class<RotateComponent, AZ::Component>()
                        

                            
13
                            
                ->Version(1)
                        

                            
14
                            
                ->Field("RotationSpeed", &RotateComponent::m_rotationSpeedDegreesPerSecond)
                        

                            
15
                            
                    ->Attribute(AZ::Edit::Attributes::ChangeNotify, AZ::Edit::PropertyRefreshLevels::EntireTree) // 添加 ChangeNotify 属性
                        

                            
16
                            
            ;
                        

                            
17
                            

                        

                            
18
                            
            // ... (编辑器上下文注册) ...
                        

                            
19
                            
        }
                        

                            
20
                            
    }
                        

                            
21
                            

                        

                            
22
                            
    // ... (其他函数) ...
                        

                            
23
                            

                        

                            
24
                            
    void RotateComponent::SetRotationSpeedDegreesPerSecond(float speed)
                        

                            
25
                            
    {
                        

                            
26
                            
        if (m_rotationSpeedDegreesPerSecond != speed)
                        

                            
27
                            
        {
                        

                            
28
                            
            m_rotationSpeedDegreesPerSecond = speed;
                        

                            
29
                            
            RotateComponentNotificationBus::Broadcast(&RotateComponentNotificationBus::OnRotationSpeedChanged, m_rotationSpeedDegreesPerSecond); // 发布事件
                        

                            
30
                            
        }
                        

                            
31
                            
    }
                        

                            
32
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
#pragma once
                        

                            
2
                            

                        

                            
3
                            
#include <AzCore/Component/Component.h>
                        

                            
4
                            
#include <AzCore/Serialization/SerializeContext.h>
                        

                            
5
                            
#include <AzCore/RTTI/RTTI.h>
                        

                            
6
                            
#include <AzCore/std/string/string.h>
                        

                            
7
                            
#include "RotateComponentNotificationBus.h" // 引入 EBus 接口头文件
                        

                            
8
                            

                        

                            
9
                            
namespace O3DEBook
                        

                            
10
                            
{
                        

                            
11
                            
    class RotationSpeedDisplayComponent final : public AZ::Component
                        

                            
12
                            
        , public RotateComponentNotificationBus::Handler // 继承 EBus Handler
                        

                            
13
                            
    {
                        

                            
14
                            
    public:
                        

                            
15
                            
        AZ_COMPONENT(RotationSpeedDisplayComponent, "{YOUR-UNIQUE-UUID-HERE}");
                        

                            
16
                            

                        

                            
17
                            
        static void Reflect(AZ::ReflectContext* context);
                        

                            
18
                            

                        

                            
19
                            
        RotationSpeedDisplayComponent();
                        

                            
20
                            
        ~RotationSpeedDisplayComponent() override = default;
                        

                            
21
                            

                        

                            
22
                            
    protected:
                        

                            
23
                            
        void Activate() override;
                        

                            
24
                            
        void Deactivate() override;
                        

                            
25
                            

                        

                            
26
                            
        // EBus Handler 实现
                        

                            
27
                            
        void OnRotationSpeedChanged(float newSpeed) override;
                        

                            
28
                            

                        

                            
29
                            
    private:
                        

                            
30
                            
        AZStd::string m_displayText; // 显示文本
                        

                            
31
                            
    };
                        

                            
32
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
#include "RotationSpeedDisplayComponent.h"
                        

                            
2
                            

                        

                            
3
                            
#include <AzCore/Serialization/EditContext.h>
                        

                            
4
                            
#include <AzFramework/Components/ надписьComponentBus.h> // 假设有 надписьComponent 用于显示文本 (需要替换为实际的UI文本组件)
                        

                            
5
                            

                        

                            
6
                            
namespace O3DEBook
                        

                            
7
                            
{
                        

                            
8
                            
    void RotationSpeedDisplayComponent::Reflect(AZ::ReflectContext* context)
                        

                            
9
                            
    {
                        

                            
10
                            
        if (AZ::SerializeContext* serializeContext = azrtti_cast<AZ::SerializeContext*>(context))
                        

                            
11
                            
        {
                        

                            
12
                            
            serializeContext->Class<RotationSpeedDisplayComponent, AZ::Component>()
                        

                            
13
                            
                ->Version(1)
                        

                            
14
                            
            ;
                        

                            
15
                            

                        

                            
16
                            
            if (AZ::EditContext* editContext = serializeContext->GetEditContext())
                        

                            
17
                            
            {
                        

                            
18
                            
                editContext->Class<RotationSpeedDisplayComponent>("Rotation Speed Display Component", "Displays the rotation speed")
                        

                            
19
                            
                    ->ClassElement(AZ::Edit::ClassElements::EditorData, "")
                        

                            
20
                            
                        ->Attribute(AZ::Edit::Attributes::AutoExpand, true)
                        

                            
21
                            
                ;
                        

                            
22
                            
            }
                        

                            
23
                            
        }
                        

                            
24
                            
    }
                        

                            
25
                            

                        

                            
26
                            
    RotationSpeedDisplayComponent::RotationSpeedDisplayComponent()
                        

                            
27
                            
    {
                        

                            
28
                            
    }
                        

                            
29
                            

                        

                            
30
                            
    void RotationSpeedDisplayComponent::Activate()
                        

                            
31
                            
    {
                        

                            
32
                            
        // 连接到 EBus，使用实体 ID 作为 BusId
                        

                            
33
                            
        RotateComponentNotificationBus::Handler::BusConnect(GetEntityId());
                        

                            
34
                            
    }
                        

                            
35
                            

                        

                            
36
                            
    void RotationSpeedDisplayComponent::Deactivate()
                        

                            
37
                            
    {
                        

                            
38
                            
        // 断开 EBus 连接
                        

                            
39
                            
        RotateComponentNotificationBus::Handler::BusDisconnect();
                        

                            
40
                            
    }
                        

                            
41
                            

                        

                            
42
                            
    void RotationSpeedDisplayComponent::OnRotationSpeedChanged(float newSpeed)
                        

                            
43
                            
    {
                        

                            
44
                            
        // 更新显示文本 (需要替换为实际的UI文本组件操作)
                        

                            
45
                            
        m_displayText = AZStd::String::Printf("Rotation Speed: %.2f deg/s", newSpeed);
                        

                            
46
                            
        // надписьComponentBus::Broadcast::SetText(GetEntityId(), m_displayText); // 假设的 надписьComponent 设置文本方法
                        

                            
47
                            
        AZ_Printf("RotationSpeedDisplayComponent", "%s\n", m_displayText.c_str()); // 临时使用 AZ_Printf 输出
                        

                            
48
                            
    }
                        

                            
49
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
Gems/
                        

                            
2
                            
└── MyCustomGem/                  // Gem 根目录，Gem Name
                        

                            
3
                            
    ├── Assets/                 // 资源目录
                        

                            
4
                            
    │   └── ...                 // 资源文件 (材质, 纹理, 模型等)
                        

                            
5
                            
    ├── Code/                   // 代码目录
                        

                            
6
                            
    │   ├── Source/            // 源代码目录
                        

                            
7
                            
    │   │   ├── MyCustomGemModule.cpp // Gem 模块入口文件
                        

                            
8
                            
    │   │   ├── MyComponent.h     // 自定义组件头文件
                        

                            
9
                            
    │   │   └── MyComponent.cpp   // 自定义组件源文件
                        

                            
10
                            
    │   ├── include/           // 头文件目录
                        

                            
11
                            
    │   │   └── MyCustomGem/    // Gem 命名空间目录
                        

                            
12
                            
    │   │       ├── MyCustomGemTypeIds.h // 类型 ID 定义头文件
                        

                            
13
                            
    │   │       └── MyComponent.h     // 组件头文件 (符号链接到 Source/include)
                        

                            
14
                            
    │   └── wscript              // Waf 构建脚本
                        

                            
15
                            
    ├── Editor/                 // 编辑器扩展目录 (可选)
                        

                            
16
                            
    │   ├── Source/            // 编辑器扩展源代码目录
                        

                            
17
                            
    │   │   ├── MyCustomGemEditorModule.cpp // 编辑器模块入口文件
                        

                            
18
                            
    │   │   └── ...             // 编辑器扩展代码
                        

                            
19
                            
    │   ├── include/           // 编辑器扩展头文件目录
                        

                            
20
                            
    │   │   └── MyCustomGemEditor/ // 编辑器命名空间目录
                        

                            
21
                            
    │   │       └── ...         // 编辑器扩展头文件
                        

                            
22
                            
    │   └── wscript              // 编辑器构建脚本
                        

                            
23
                            
    ├── Gem.json                // Gem 描述文件
                        

                            
24
                            
    └── wscript                 // 顶层构建脚本
                        
                                
                            

                                
                                    

                            
1
                            
{
                        

                            
2
                            
    "GemName": "MyCustomGem",
                        

                            
3
                            
    "DisplayName": "My Custom Gem",
                        

                            
4
                            
    "Version": "1.0.0",
                        

                            
5
                            
    "Uuid": "{YOUR-GEM-UUID-HERE}", // 替换为你的 Gem UUID
                        

                            
6
                            
    "Description": "This is my custom Gem for O3DE engine.",
                        

                            
7
                            
    "Tags": ["Example", "Custom"],
                        

                            
8
                            
    "Author": "Your Name",
                        

                            
9
                            
    "Copyright": "Copyright (c) 2023 Your Company",
                        

                            
10
                            
    "Summary": "Provides custom components and features.",
                        

                            
11
                            
    "Dependencies": [] , // 依赖的其他 Gem 列表
                        

                            
12
                            
    "IconPath": "Assets/Icons/GemIcon.png" // Gem 图标路径 (可选)
                        

                            
13
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
#include "MyCustomGemModule.h"
                        

                            
2
                            
#include "MyComponent.h" // 引入自定义组件头文件
                        

                            
3
                            

                        

                            
4
                            
#include <AzCore/Module/Module.h>
                        

                            
5
                            
#include <AzCore/Serialization/SerializeContext.h>
                        

                            
6
                            

                        

                            
7
                            
namespace MyCustomGem
                        

                            
8
                            
{
                        

                            
9
                            
    class MyCustomGemModule
                        

                            
10
                            
        : public AZ::Module
                        

                            
11
                            
    {
                        

                            
12
                            
    public:
                        

                            
13
                            
        AZ_RTTI(MyCustomGemModule, "{YOUR-MODULE-UUID-HERE}", AZ::Module); // 可以使用新的 UUID，或者 Gem 的 UUID
                        

                            
14
                            

                        

                            
15
                            
        MyCustomGemModule()
                        

                            
16
                            
        {
                        

                            
17
                            
            // 设置模块的属性，例如是否在编辑器中加载
                        

                            
18
                            
            m_descriptor.m_prettyName = "MyCustomGem";
                        

                            
19
                            
            m_descriptor.m_busId = MyCustomGemModuleInterface::GetBusId();
                        

                            
20
                            
            m_descriptor.m_version = 1;
                        

                            
21
                            
            m_descriptor.m_type = AZ::ModuleDescriptor::ModuleType::NativeGem;
                        

                            
22
                            
        }
                        

                            
23
                            

                        

                            
24
                            
        /**
                        

                            
25
                            
         * Module overrides
                        

                            
26
                            
         */
                        

                            
27
                            
        AZ::ComponentTypeList GetRequiredServices() override
                        

                            
28
                            
        {
                        

                            
29
                            
            return AZ::ComponentTypeList{
                        

                            
30
                            
                azrtti_typeid<MyCustomGemModuleInterface>(),
                        

                            
31
                            
            };
                        

                            
32
                            
        }
                        

                            
33
                            

                        

                            
34
                            
        AZ::ComponentTypeList GetProvidedServices() override
                        

                            
35
                            
        {
                        

                            
36
                            
            return AZ::ComponentTypeList{
                        

                            
37
                            
                azrtti_typeid<MyCustomGemModuleInterface>(),
                        

                            
38
                            
            };
                        

                            
39
                            
        }
                        

                            
40
                            

                        

                            
41
                            
        AZ::ComponentTypeList GetIncompatibleServices() override
                        

                            
42
                            
        {
                        

                            
43
                            
            return AZ::ComponentTypeList{
                        

                            
44
                            
                azrtti_typeid<MyCustomGemModuleInterface>(),
                        

                            
45
                            
            };
                        

                            
46
                            
        }
                        

                            
47
                            

                        

                            
48
                            
        void Reflect(AZ::ReflectContext* context) override
                        

                            
49
                            
        {
                        

                            
50
                            
            if (AZ::SerializeContext* serializeContext = azrtti_cast<AZ::SerializeContext*>(context))
                        

                            
51
                            
            {
                        

                            
52
                            
                MyComponent::Reflect(serializeContext); // 注册自定义组件的反射信息
                        

                            
53
                            
            }
                        

                            
54
                            
        }
                        

                            
55
                            

                        

                            
56
                            
        AZ_DECLARE_MODULE_CLASS(MyCustomGemModule, MyCustomGemModule)
                        

                            
57
                            
    };
                        

                            
58
                            
}
                        

                            
59
                            

                        

                            
60
                            
// DO NOT MODIFY THIS LINE UNLESS YOU RENAME THE GEM
                        

                            
61
                            
// The first parameter should be GemName_GemIdGuid from the <GemName>.json file
                        

                            
62
                            
// e.g MyCustomGem_GemIdGuid
                        

                            
63
                            
AZ_DECLARE_MODULE_INSTANCE(MyCustomGem_GemIdGuid, MyCustomGem::MyCustomGemModule) // 替换为你的 Gem Name 和 GemIdGuid
                        
                                
                            

                                
                                    

                            
1
                            
void RotateComponent::OnTick(float deltaTime, AZ::TickBus::TickType tickType)
                        

                            
2
                            
{
                        

                            
3
                            
    AZ_Printf("RotateComponent", "OnTick called, deltaTime: %f\n", deltaTime);
                        

                            
4
                            

                        

                            
5
                            
    AZ::TransformComponentInterface* transform = AZ::Interface<AZ::TransformComponentInterface>::Get();
                        

                            
6
                            
    if (!transform)
                        

                            
7
                            
    {
                        

                            
8
                            
        AZ_Error("RotateComponent", false, "TransformComponentInterface not found!\n");
                        

                            
9
                            
        return;
                        

                            
10
                            
    }
                        

                            
11
                            

                        

                            
12
                            
    // ... (其他代码) ...
                        

                            
13
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
void RotateComponent::SetRotationSpeedDegreesPerSecond(float speed)
                        

                            
2
                            
{
                        

                            
3
                            
    AZ_Assert(speed >= 0.0f && speed <= 360.0f, "Invalid rotation speed: %f, speed should be between 0 and 360.\n", speed);
                        

                            
4
                            
    m_rotationSpeedDegreesPerSecond = speed;
                        

                            
5
                            
}
                        
                                
                            

                                
                                    

                            
1
                            
//  这是一个简单的示例，展示了如何使用 Script Canvas 创建一个点击鼠标左键生成 Cube 的脚本。
                        

                            
2
                            
//  请注意，实际操作需要在 O3DE 编辑器中完成，这里仅为代码形式的描述。
                        

                            
3
                            

                        

                            
4
                            
//  1. 创建 Script Canvas 资源 (例如: CreateCubeOnMouseClick.scriptcanvas)
                        

                            
5
                            

                        

                            
6
                            
//  2. 打开 Script Canvas 编辑器
                        

                            
7
                            

                        

                            
8
                            
//  3. 添加节点:
                        

                            
9
                            
//     - Event: Input -> Mouse Button Pressed (鼠标按键按下事件)
                        

                            
10
                            
//         - 配置: Button -> Left (左键)
                        

                            
11
                            
//     - Flow: If (条件判断)
                        

                            
12
                            
//         - 条件:  Mouse Button Pressed 节点的 "Pressed" 输出
                        

                            
13
                            
//     - Entity: Create Entity (创建实体)
                        

                            
14
                            
//         - 配置: Entity Name -> "GeneratedCube"
                        

                            
15
                            
//     - Component: Add Component -> Mesh (添加网格组件)
                        

                            
16
                            
//         - 配置: Mesh Asset ->  选择一个 Cube 网格资源 (例如:  EngineAssets:Primitives/Cube.prefab)
                        

                            
17
                            
//         - 关联:  Entity -> Create Entity 节点的 "Out Entity" 输出
                        

                            
18
                            
//     - Component: Add Component -> Transform (添加变换组件)
                        

                            
19
                            
//         - 关联:  Entity -> Create Entity 节点的 "Out Entity" 输出
                        

                            
20
                            

                        

                            
21
                            
//  4. 连接节点:
                        

                            
22
                            
//     - Mouse Button Pressed 节点的 "Out"  -> If 节点的 "In"
                        

                            
23
                            
//     - If 节点的 "True" -> Create Entity 节点的 "In"
                        

                            
24
                            
//     - Create Entity 节点的 "Out" -> Add Component (Mesh) 节点的 "In"
                        

                            
25
                            
//     - Add Component (Mesh) 节点的 "Out" -> Add Component (Transform) 节点的 "In"
                        

                            
26
                            

                        

                            
27
                            
//  5. 保存 Script Canvas 脚本
                        

                            
28
                            

                        

                            
29
                            
//  6. 在场景中创建一个 Entity (例如: ScriptController)
                        

                            
30
                            

                        

                            
31
                            
//  7. 为 ScriptController Entity 添加 Script Canvas 组件
                        

                            
32
                            

                        

                            
33
                            
//  8. 在 Script Canvas 组件的属性面板中，将 "Script Canvas Asset" 设置为 "CreateCubeOnMouseClick.scriptcanvas"
                        

                            
34
                            

                        

                            
35
                            
//  9. 运行游戏，点击鼠标左键，将在场景原点创建一个 Cube 实体。
                        
                                
                            

                                
                                    

                            
1
                            
--  变量赋值
                        

                            
2
                            
message = "Hello, Lua!"
                        

                            
3
                            
count = 10
                        

                            
4
                            
is_active = true
                        
                                
                            

                                
                                    

                            
1
                            
if score > 100 then
                        

                            
2
                            
  print("Excellent!")
                        

                            
3
                            
elseif score > 50 then
                        

                            
4
                            
  print("Good job!")
                        

                            
5
                            
else
                        

                            
6
                            
  print("Try harder!")
                        

                            
7
                            
end
                        
                                
                            

                                
                                    

                            
1
                            
--  while 循环
                        

                            
2
                            
i = 1
                        

                            
3
                            
while i <= 5 do
                        

                            
4
                            
  print(i)
                        

                            
5
                            
  i = i + 1
                        

                            
6
                            
end
                        

                            
7
                            

                        

                            
8
                            
--  for 循环 (数值型)
                        

                            
9
                            
for i = 1, 5 do
                        

                            
10
                            
  print(i)
                        

                            
11
                            
end
                        

                            
12
                            

                        

                            
13
                            
--  for 循环 (泛型，遍历 table)
                        

                            
14
                            
my_table = {a = 1, b = 2, c = 3}
                        

                            
15
                            
for key, value in pairs(my_table) do
                        

                            
16
                            
  print(key, value)
                        

                            
17
                            
end
                        
                                
                            

                                
                                    

                            
1
                            
--  函数定义
                        

                            
2
                            
function add(a, b)
                        

                            
3
                            
  return a + b
                        

                            
4
                            
end
                        

                            
5
                            

                        

                            
6
                            
--  函数调用
                        

                            
7
                            
sum = add(5, 3)
                        

                            
8
                            
print(sum)  --  输出 8
                        
                                
                            

                                
                                    

                            
1
                            
--  创建表
                        

                            
2
                            
my_array = {10, 20, 30, 40}  --  数组
                        

                            
3
                            
my_dict = {name = "Player", health = 100}  --  字典
                        

                            
4
                            

                        

                            
5
                            
--  访问表元素
                        

                            
6
                            
print(my_array[1])  --  输出 10 (Lua 数组索引从 1 开始)
                        

                            
7
                            
print(my_dict.name)  --  输出 "Player"
                        

                            
8
                            
print(my_dict["health"])  --  输出 100
                        
                                
                            

                                
                                    

                            
1
                            
--  创建实体
                        

                            
2
                            
local entity = Entity.Create()
                        

                            
3
                            
Entity.SetName(entity, "MyLuaEntity")
                        

                            
4
                            

                        

                            
5
                            
--  查找实体 (通过名字)
                        

                            
6
                            
local found_entity = Entity.FindByName("MyLuaEntity")
                        

                            
7
                            

                        

                            
8
                            
--  销毁实体
                        

                            
9
                            
Entity.Destroy(entity)
                        
                                
                            

                                
                                    

                            
1
                            
--  获取 Transform 组件
                        

                            
2
                            
local transform_component = Entity.GetComponent(entity, "Transform")
                        

                            
3
                            

                        

                            
4
                            
--  设置 Transform 组件的 Translation 属性
                        

                            
5
                            
TransformComponent.SetLocalTranslation(transform_component, Vector3(1, 2, 3))
                        

                            
6
                            

                        

                            
7
                            
--  添加 Mesh 组件
                        

                            
8
                            
Entity.AddComponent(entity, "Mesh")
                        

                            
9
                            
local mesh_component = Entity.GetComponent(entity, "Mesh")
                        

                            
10
                            
MeshComponent.SetMeshAsset(mesh_component, "{Asset path to mesh}")
                        
                                
                            

                                
                                    

                            
1
                            
--  检查按键是否按下
                        

                            
2
                            
if Input.IsKeyDown("Keyboard_Space") then
                        

                            
3
                            
  print("Space key is pressed!")
                        

                            
4
                            
end
                        

                            
5
                            

                        

                            
6
                            
--  获取鼠标位置
                        

                            
7
                            
local mouse_pos = Input.GetMousePosition()
                        

                            
8
                            
print("Mouse X:", mouse_pos.x, "Mouse Y:", mouse_pos.y)
                        
                                
                            

                                
                                    

                            
1
                            
--  MyEntityPositionScript.lua
                        

                            
2
                            

                        

                            
3
                            
--  获取实体 Transform 组件
                        

                            
4
                            
local transform_component = Entity.GetComponent(entity, "Transform")
                        

                            
5
                            

                        

                            
6
                            
--  每帧执行的函数 (OnTick)
                        

                            
7
                            
function OnTick(deltaTime)
                        

                            
8
                            
  if transform_component then
                        

                            
9
                            
    --  获取实体世界坐标
                        

                            
10
                            
    local world_pos = TransformComponent.GetWorldTranslation(transform_component)
                        

                            
11
                            
    Debug.Log("Entity Position: X=", world_pos.x, "Y=", world_pos.y, "Z=", world_pos.z)
                        

                            
12
                            
  end
                        

                            
13
                            
end
                        
                                
                            

                                
                                    

                            
1
                            
--  MyLuaFunctions.lua
                        

                            
2
                            

                        

                            
3
                            
--  Lua 函数：计算两个数的平方和
                        

                            
4
                            
function SquareSum(a, b)
                        

                            
5
                            
  return a * a + b * b
                        

                            
6
                            
end
                        

                            
7
                            

                        

                            
8
                            
--  Lua 函数：打印消息
                        

                            
9
                            
function PrintMessage(message)
                        

                            
10
                            
  Debug.Log("Lua Message: " .. message)
                        

                            
11
                            
end
                        
                                
                            

                                
                                    

                            
1
                            
//  Script Canvas 脚本示例 (CallLuaFunction.scriptcanvas)
                        

                            
2
                            

                        

                            
3
                            
//  1. 添加节点:
                        

                            
4
                            
//     - Event: On Graph Start (图表启动事件)
                        

                            
5
                            
//     - Data: Number Constant (数值常量) x 2  (分别设置为 3 和 4)
                        

                            
6
                            
//     - Script: Lua Script (Lua 脚本节点)
                        

                            
7
                            
//         - 配置:
                        

                            
8
                            
//             - Script Asset:  选择 "MyLuaFunctions.lua"
                        

                            
9
                            
//             - Function Name:  "SquareSum"
                        

                            
10
                            
//             - Input Ports:
                        

                            
11
                            
//                 - a (Number)
                        

                            
12
                            
//                 - b (Number)
                        

                            
13
                            
//             - Output Ports:
                        

                            
14
                            
//                 - Result (Number)
                        

                            
15
                            
//     - Debug: Log (日志输出节点)
                        

                            
16
                            

                        

                            
17
                            
//  2. 连接节点:
                        

                            
18
                            
//     - On Graph Start 节点的 "Out" -> Lua Script 节点的 "In"
                        

                            
19
                            
//     - Number Constant (3) 节点的 "Value" -> Lua Script 节点的 "a"
                        

                            
20
                            
//     - Number Constant (4) 节点的 "Value" -> Lua Script 节点的 "b"
                        

                            
21
                            
//     - Lua Script 节点的 "Result" -> Log 节点的 "Value"
                        

                            
22
                            

                        

                            
23
                            
//  3. 创建一个 Entity，添加 Script Canvas 组件，并将 "CallLuaFunction.scriptcanvas" 关联到组件。
                        

                            
24
                            

                        

                            
25
                            
//  4. 运行游戏，将在控制台看到 Lua 函数计算的平方和结果 (3*3 + 4*4 = 25)。
                        
                                
                            

                                
                                    

                            
1
                            
--  Lua 脚本示例 (SendCustomEvent.lua)
                        

                            
2
                            

                        

                            
3
                            
--  发送自定义事件 "MyCustomEvent" 到实体自身
                        

                            
4
                            
function SendEventToSelf()
                        

                            
5
                            
  EventBus.Broadcast("MyCustomEvent", entity, "Hello from Lua!")
                        

                            
6
                            
end
                        

                            
7
                            

                        

                            
8
                            
--  在某个事件触发时调用 SendEventToSelf 函数 (例如，按键按下事件)
                        

                            
9
                            
if Input.IsKeyPressed("Keyboard_E") then
                        

                            
10
                            
  SendEventToSelf()
                        

                            
11
                            
end
                        
                                
                            

                                
                                    

                            
1
                            
//  Script Canvas 脚本示例 (PlayerMovement.scriptcanvas)
                        

                            
2
                            

                        

                            
3
                            
//  实现 WASD 按键控制角色前后左右移动
                        

                            
4
                            

                        

                            
5
                            
//  1. 添加组件到 Player Entity:
                        

                            
6
                            
//     - Transform 组件 (用于控制位置)
                        

                            
7
                            
//     - Simple Motion 组件 (用于简化移动)
                        

                            
8
                            

                        

                            
9
                            
//  2. Script Canvas 节点:
                        

                            
10
                            
//     - Event: Input -> Keyboard Input (键盘输入事件) x 4 (分别监听 W, A, S, D 按键)
                        

                            
11
                            
//     - Data: Number Constant (数值常量) x 4 (移动速度，例如 5)
                        

                            
12
                            
//     - Math: Vector3 -> Make Vector3 (创建三维向量) x 4 (分别表示 前、左、后、右 移动方向)
                        

                            
13
                            
//         - 前: (0, 0, 1)
                        

                            
14
                            
//         - 左: (-1, 0, 0)
                        

                            
15
                            
//         - 后: (0, 0, -1)
                        

                            
16
                            
//         - 右: (1, 0, 0)
                        

                            
17
                            
//     - Component: Simple Motion -> Apply толчок (施加推力) x 4
                        

                            
18
                            
//         - 关联: Entity -> Self (自身实体)
                        

                            
19
                            
//     - Flow: Gate (门控) x 4 (用于控制移动方向的激活)
                        

                            
20
                            

                        

                            
21
                            
//  3. 连接节点:
                        

                            
22
                            
//     - Keyboard Input (W) 节点的 "Pressed" -> Gate (前) 节点的 "Open"
                        

                            
23
                            
//     - Keyboard Input (A) 节点的 "Pressed" -> Gate (左) 节点的 "Open"
                        

                            
24
                            
//     - Keyboard Input (S) 节点的 "Pressed" -> Gate (后) 节点的 "Open"
                        

                            
25
                            
//     - Keyboard Input (D) 节点的 "Pressed" -> Gate (右) 节点的 "Open"
                        

                            
26
                            

                        

                            
27
                            
//     - Gate (前) 节点的 "Out" -> Simple Motion -> Apply толчок (前) 节点的 "In"
                        

                            
28
                            
//     - Gate (左) 节点的 "Out" -> Simple Motion -> Apply толчок (左) 节点的 "In"
                        

                            
29
                            
//     - Gate (后) 节点的 "Out" -> Simple Motion -> Apply толчок (后) 节点的 "In"
                        

                            
30
                            
//     - Gate (右) 节点的 "Out" -> Simple Motion -> Apply толчок (右) 节点的 "In"
                        

                            
31
                            

                        

                            
32
                            
//     - Number Constant (速度) 节点的 "Value" -> Simple Motion -> Apply толчок (前/左/后/右) 节点的 "Speed"
                        

                            
33
                            
//     - Make Vector3 (方向) 节点的 "Vector" -> Simple Motion -> Apply толчок (前/左/后/右) 节点的 "Direction"