@leejungkiin/awkit 1.5.4 → 1.5.6

package/skill-packs/cocos2d/skills/cocos2d-x/examples/core/action.md

@@ -0,0 +1,278 @@
+# Action（动作）系统使用指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## 概述
+
+Action 系统用于对节点执行各种变换操作，如移动、旋转、缩放等。
+
+## 基本动作
+
+### 移动动作
+
+```cpp
+auto sprite = Sprite::create("player.png");
+this->addChild(sprite);
+
+// 移动到指定位置
+auto moveTo = MoveTo::create(2.0f, Vec2(400, 300));
+sprite->runAction(moveTo);
+
+// 相对移动
+auto moveBy = MoveBy::create(1.0f, Vec2(100, 50));
+sprite->runAction(moveBy);
+```
+
+### 旋转动作
+
+```cpp
+// 旋转到指定角度
+auto rotateTo = RotateTo::create(2.0f, 90.0f);
+sprite->runAction(rotateTo);
+
+// 相对旋转
+auto rotateBy = RotateBy::create(1.0f, 180.0f);
+sprite->runAction(rotateBy);
+```
+
+### 缩放动作
+
+```cpp
+// 缩放到指定大小
+auto scaleTo = ScaleTo::create(1.0f, 2.0f);
+sprite->runAction(scaleTo);
+
+// 相对缩放
+auto scaleBy = ScaleBy::create(1.0f, 1.5f);
+sprite->runAction(scaleBy);
+```
+
+### 淡入淡出
+
+```cpp
+// 淡入
+auto fadeIn = FadeIn::create(1.0f);
+sprite->runAction(fadeIn);
+
+// 淡出
+auto fadeOut = FadeOut::create(1.0f);
+sprite->runAction(fadeOut);
+
+// 淡入到指定透明度
+auto fadeTo = FadeTo::create(1.0f, 128);
+sprite->runAction(fadeTo);
+```
+
+### 跳跃动作
+
+```cpp
+// 跳跃到指定位置
+auto jumpTo = JumpTo::create(2.0f, Vec2(400, 300), 100, 3);
+sprite->runAction(jumpTo);
+
+// 相对跳跃
+auto jumpBy = JumpBy::create(1.0f, Vec2(100, 0), 50, 2);
+sprite->runAction(jumpBy);
+```
+
+## 组合动作
+
+### 序列动作（Sequence）
+
+```cpp
+// 按顺序执行多个动作
+auto move1 = MoveBy::create(1.0f, Vec2(100, 0));
+auto move2 = MoveBy::create(1.0f, Vec2(0, 100));
+auto move3 = MoveBy::create(1.0f, Vec2(-100, 0));
+
+auto sequence = Sequence::create(move1, move2, move3, nullptr);
+sprite->runAction(sequence);
+```
+
+### 同时执行（Spawn）
+
+```cpp
+// 同时执行多个动作
+auto move = MoveBy::create(2.0f, Vec2(200, 0));
+auto rotate = RotateBy::create(2.0f, 360.0f);
+auto scale = ScaleBy::create(2.0f, 1.5f);
+
+auto spawn = Spawn::create(move, rotate, scale, nullptr);
+sprite->runAction(spawn);
+```
+
+### 重复动作
+
+```cpp
+// 重复指定次数
+auto move = MoveBy::create(1.0f, Vec2(100, 0));
+auto repeat = Repeat::create(move, 3);
+sprite->runAction(repeat);
+
+// 无限重复
+auto repeatForever = RepeatForever::create(move);
+sprite->runAction(repeatForever);
+```
+
+### 延迟动作
+
+```cpp
+// 延迟执行
+auto delay = DelayTime::create(2.0f);
+auto move = MoveBy::create(1.0f, Vec2(100, 0));
+auto sequence = Sequence::create(delay, move, nullptr);
+sprite->runAction(sequence);
+```
+
+## 缓动函数
+
+### 使用 Ease
+
+```cpp
+auto move = MoveBy::create(2.0f, Vec2(400, 0));
+
+// 缓入
+auto easeIn = EaseIn::create(move, 2.0f);
+sprite->runAction(easeIn);
+
+// 缓出
+auto easeOut = EaseOut::create(move, 2.0f);
+sprite->runAction(easeOut);
+
+// 缓入缓出
+auto easeInOut = EaseInOut::create(move, 2.0f);
+sprite->runAction(easeInOut);
+
+// 弹性效果
+auto elastic = EaseElasticInOut::create(move, 0.5f);
+sprite->runAction(elastic);
+
+// 弹跳效果
+auto bounce = EaseBounceInOut::create(move);
+sprite->runAction(bounce);
+```
+
+## 回调动作
+
+```cpp
+// 动作完成后执行回调
+auto move = MoveBy::create(2.0f, Vec2(400, 0));
+auto callback = CallFunc::create([sprite](){
+    log("Action completed!");
+    sprite->setColor(Color3B::RED);
+});
+
+auto sequence = Sequence::create(move, callback, nullptr);
+sprite->runAction(sequence);
+```
+
+## 完整示例
+
+```cpp
+class ActionDemo : public Scene
+{
+public:
+    static Scene* createScene();
+    virtual bool init();
+    CREATE_FUNC(ActionDemo);
+    
+private:
+    void createMovingSprite();
+    void createRotatingSprite();
+    void createScalingSprite();
+};
+
+bool ActionDemo::init()
+{
+    if (!Scene::init())
+    {
+        return false;
+    }
+    
+    createMovingSprite();
+    createRotatingSprite();
+    createScalingSprite();
+    
+    return true;
+}
+
+void ActionDemo::createMovingSprite()
+{
+    auto sprite = Sprite::create("player.png");
+    sprite->setPosition(Vec2(100, 200));
+    this->addChild(sprite);
+    
+    // 创建来回移动的动画
+    auto moveRight = MoveBy::create(2.0f, Vec2(400, 0));
+    auto moveLeft = MoveBy::create(2.0f, Vec2(-400, 0));
+    auto sequence = Sequence::create(moveRight, moveLeft, nullptr);
+    auto repeat = RepeatForever::create(sequence);
+    
+    sprite->runAction(repeat);
+}
+
+void ActionDemo::createRotatingSprite()
+{
+    auto sprite = Sprite::create("player.png");
+    sprite->setPosition(Vec2(400, 300));
+    this->addChild(sprite);
+    
+    // 持续旋转
+    auto rotate = RotateBy::create(2.0f, 360.0f);
+    auto repeat = RepeatForever::create(rotate);
+    sprite->runAction(repeat);
+}
+
+void ActionDemo::createScalingSprite()
+{
+    auto sprite = Sprite::create("player.png");
+    sprite->setPosition(Vec2(700, 200));
+    this->addChild(sprite);
+    
+    // 缩放动画
+    auto scaleUp = ScaleTo::create(1.0f, 1.5f);
+    auto scaleDown = ScaleTo::create(1.0f, 1.0f);
+    auto sequence = Sequence::create(scaleUp, scaleDown, nullptr);
+    auto repeat = RepeatForever::create(sequence);
+    
+    sprite->runAction(repeat);
+}
+```
+
+## 动作管理
+
+### 停止动作
+
+```cpp
+// 停止所有动作
+sprite->stopAllActions();
+
+// 停止指定动作
+auto action = sprite->getActionByTag(100);
+if (action)
+{
+    sprite->stopAction(action);
+}
+
+// 停止指定标签的动作
+sprite->stopActionByTag(100);
+```
+
+### 动作标签
+
+```cpp
+auto move = MoveBy::create(2.0f, Vec2(400, 0));
+move->setTag(100);
+sprite->runAction(move);
+
+// 稍后可以通过标签获取
+auto action = sprite->getActionByTag(100);
+```
+
+## 参考资源
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Sprite 指南**: `examples/core/sprite.md`
+- **Scene 指南**: `examples/core/scene.md`

package/skill-packs/cocos2d/skills/cocos2d-x/examples/core/animation.md

@@ -0,0 +1,220 @@
+# Animation（动画）系统使用指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## Instructions
+
+Animation 系统用于创建帧动画。通过 SpriteFrame 序列创建 Animation，然后使用 Animate 动作播放。
+
+### Syntax
+
+#### 动画创建流程
+
+1. 加载 SpriteFrame 到缓存
+2. 创建 SpriteFrame 序列
+3. 使用序列创建 Animation
+4. 使用 Animate 创建动作
+5. 在 Sprite 上运行动作
+
+#### 关键类
+
+- `SpriteFrameCache` - 精灵帧缓存
+- `SpriteFrame` - 单个精灵帧
+- `Animation` - 动画对象
+- `Animate` - 动画动作
+
+### Example (基本帧动画)
+
+```cpp
+// 加载精灵帧到缓存
+auto cache = SpriteFrameCache::getInstance();
+cache->addSpriteFramesWithFile("player.plist", "player.png");
+
+// 创建精灵帧序列
+Vector<SpriteFrame*> frames;
+for (int i = 1; i <= 4; i++)
+{
+    std::string frameName = StringUtils::format("player_walk_%02d.png", i);
+    auto frame = cache->getSpriteFrameByName(frameName);
+    if (frame)
+    {
+        frames.pushBack(frame);
+    }
+}
+
+// 创建动画（每帧 0.1 秒）
+auto animation = Animation::createWithSpriteFrames(frames, 0.1f);
+
+// 创建动画动作
+auto animate = Animate::create(animation);
+
+// 无限循环播放
+auto repeat = RepeatForever::create(animate);
+
+// 在精灵上运行动作
+auto sprite = Sprite::createWithSpriteFrameName("player_walk_01.png");
+sprite->runAction(repeat);
+this->addChild(sprite);
+```
+
+### Example (动画控制)
+
+```cpp
+// 创建动画
+auto animation = Animation::createWithSpriteFrames(frames, 0.1f);
+auto animate = Animate::create(animation);
+
+// 播放一次
+sprite->runAction(animate);
+
+// 播放指定次数
+auto repeat = Repeat::create(animate, 3);
+sprite->runAction(repeat);
+
+// 无限循环
+auto repeatForever = RepeatForever::create(animate);
+sprite->runAction(repeatForever);
+
+// 停止动画
+sprite->stopAllActions();
+```
+
+### Example (多个动画)
+
+```cpp
+class Player : public Sprite
+{
+public:
+    CREATE_FUNC(Player);
+    virtual bool init() override;
+    
+    void playIdleAnimation();
+    void playWalkAnimation();
+    void playJumpAnimation();
+    
+private:
+    Animation* _idleAnimation;
+    Animation* _walkAnimation;
+    Animation* _jumpAnimation;
+    Animate* _currentAnimate;
+};
+
+bool Player::init()
+{
+    if (!Sprite::init())
+    {
+        return false;
+    }
+    
+    auto cache = SpriteFrameCache::getInstance();
+    cache->addSpriteFramesWithFile("player.plist", "player.png");
+    
+    // 创建待机动画
+    Vector<SpriteFrame*> idleFrames;
+    for (int i = 1; i <= 2; i++)
+    {
+        auto frame = cache->getSpriteFrameByName(
+            StringUtils::format("player_idle_%02d.png", i));
+        idleFrames.pushBack(frame);
+    }
+    _idleAnimation = Animation::createWithSpriteFrames(idleFrames, 0.2f);
+    _idleAnimation->setRestoreOriginalFrame(true);
+    
+    // 创建行走动画
+    Vector<SpriteFrame*> walkFrames;
+    for (int i = 1; i <= 4; i++)
+    {
+        auto frame = cache->getSpriteFrameByName(
+            StringUtils::format("player_walk_%02d.png", i));
+        walkFrames.pushBack(frame);
+    }
+    _walkAnimation = Animation::createWithSpriteFrames(walkFrames, 0.1f);
+    
+    // 创建跳跃动画
+    Vector<SpriteFrame*> jumpFrames;
+    for (int i = 1; i <= 3; i++)
+    {
+        auto frame = cache->getSpriteFrameByName(
+            StringUtils::format("player_jump_%02d.png", i));
+        jumpFrames.pushBack(frame);
+    }
+    _jumpAnimation = Animation::createWithSpriteFrames(jumpFrames, 0.15f);
+    _jumpAnimation->setRestoreOriginalFrame(true);
+    
+    // 默认播放待机动画
+    playIdleAnimation();
+    
+    return true;
+}
+
+void Player::playIdleAnimation()
+{
+    this->stopAllActions();
+    _currentAnimate = Animate::create(_idleAnimation);
+    auto repeat = RepeatForever::create(_currentAnimate);
+    this->runAction(repeat);
+}
+
+void Player::playWalkAnimation()
+{
+    this->stopAllActions();
+    _currentAnimate = Animate::create(_walkAnimation);
+    auto repeat = RepeatForever::create(_currentAnimate);
+    this->runAction(repeat);
+}
+
+void Player::playJumpAnimation()
+{
+    this->stopAllActions();
+    _currentAnimate = Animate::create(_jumpAnimation);
+    this->runAction(_currentAnimate);
+    
+    // 跳跃动画结束后恢复待机
+    auto callback = CallFunc::create([this]() {
+        this->playIdleAnimation();
+    });
+    auto sequence = Sequence::create(_currentAnimate, callback, nullptr);
+    this->runAction(sequence);
+}
+```
+
+### Example (动画回调)
+
+```cpp
+// 创建动画
+auto animation = Animation::createWithSpriteFrames(frames, 0.1f);
+auto animate = Animate::create(animation);
+
+// 动画完成回调
+auto callback = CallFunc::create([sprite]() {
+    log("Animation finished");
+    sprite->setColor(Color3B::RED);
+});
+
+auto sequence = Sequence::create(animate, callback, nullptr);
+sprite->runAction(sequence);
+```
+
+### Example (动画延迟)
+
+```cpp
+// 创建动画
+auto animation = Animation::createWithSpriteFrames(frames, 0.1f);
+
+// 设置动画延迟（每帧之间的延迟）
+animation->setDelayPerUnit(0.1f);
+
+// 设置总延迟
+animation->setDelayUnits(0.5f);
+
+auto animate = Animate::create(animation);
+sprite->runAction(animate);
+```
+
+## Reference
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Sprite 指南**: `examples/core/sprite.md`
+- **Action 指南**: `examples/core/action.md`

package/skill-packs/cocos2d/skills/cocos2d-x/examples/core/event.md

@@ -0,0 +1,133 @@
+# Event（事件）系统使用指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## Instructions
+
+Cocos2d-x 使用事件分发器（EventDispatcher）来处理各种事件。事件系统支持触摸、鼠标、键盘、自定义事件等。
+
+### Syntax
+
+#### 事件监听器类型
+
+- `EventListenerTouchOneByOne` - 单点触摸事件
+- `EventListenerTouchAllAtOnce` - 多点触摸事件
+- `EventListenerMouse` - 鼠标事件
+- `EventListenerKeyboard` - 键盘事件
+- `EventListenerCustom` - 自定义事件
+
+#### 事件注册
+
+- `_eventDispatcher->addEventListenerWithSceneGraphPriority()` - 使用场景图优先级
+- `_eventDispatcher->addEventListenerWithFixedPriority()` - 使用固定优先级
+- `_eventDispatcher->removeEventListener()` - 移除事件监听器
+
+### Example (自定义事件)
+
+```cpp
+// 定义自定义事件名称
+const std::string EVENT_PLAYER_DIED = "player_died";
+const std::string EVENT_SCORE_UPDATED = "score_updated";
+
+// 创建自定义事件监听器
+auto listener = EventListenerCustom::create(EVENT_PLAYER_DIED, [](EventCustom* event) {
+    log("Player died event received");
+    // 处理玩家死亡事件
+});
+
+// 注册监听器
+_eventDispatcher->addEventListenerWithSceneGraphPriority(listener, this);
+
+// 发送自定义事件
+EventCustom event(EVENT_PLAYER_DIED);
+_eventDispatcher->dispatchEvent(&event);
+```
+
+### Example (事件优先级)
+
+```cpp
+// 场景图优先级（推荐）
+auto listener1 = EventListenerTouchOneByOne::create();
+listener1->onTouchBegan = [](Touch* touch, Event* event) { return true; };
+_eventDispatcher->addEventListenerWithSceneGraphPriority(listener1, node1);
+
+// 固定优先级
+auto listener2 = EventListenerTouchOneByOne::create();
+listener2->onTouchBegan = [](Touch* touch, Event* event) { return true; };
+_eventDispatcher->addEventListenerWithFixedPriority(listener2, 100);
+```
+
+### Example (事件冒泡)
+
+```cpp
+// 设置事件是否冒泡
+auto listener = EventListenerTouchOneByOne::create();
+listener->setSwallowTouches(true); // 阻止事件继续传播
+listener->onTouchBegan = [](Touch* touch, Event* event) {
+    return true; // 返回 true 表示处理此事件
+};
+```
+
+### Example (完整事件处理示例)
+
+```cpp
+class GameLayer : public Layer
+{
+public:
+    CREATE_FUNC(GameLayer);
+    virtual bool init() override;
+    
+private:
+    void setupEventListeners();
+    void onPlayerDied(EventCustom* event);
+    void onScoreUpdated(EventCustom* event);
+};
+
+bool GameLayer::init()
+{
+    if (!Layer::init())
+    {
+        return false;
+    }
+    
+    setupEventListeners();
+    return true;
+}
+
+void GameLayer::setupEventListeners()
+{
+    // 玩家死亡事件
+    auto playerDiedListener = EventListenerCustom::create(
+        "player_died",
+        CC_CALLBACK_1(GameLayer::onPlayerDied, this)
+    );
+    _eventDispatcher->addEventListenerWithSceneGraphPriority(playerDiedListener, this);
+    
+    // 分数更新事件
+    auto scoreListener = EventListenerCustom::create(
+        "score_updated",
+        CC_CALLBACK_1(GameLayer::onScoreUpdated, this)
+    );
+    _eventDispatcher->addEventListenerWithSceneGraphPriority(scoreListener, this);
+}
+
+void GameLayer::onPlayerDied(EventCustom* event)
+{
+    log("Player died!");
+    // 处理玩家死亡逻辑
+}
+
+void GameLayer::onScoreUpdated(EventCustom* event)
+{
+    int* score = static_cast<int*>(event->getUserData());
+    log("Score updated: %d", *score);
+    // 更新 UI
+}
+```
+
+## Reference
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Input 指南**: `examples/core/input.md`