Robot 插件

Robot 元素类似于游戏中的精灵元素，集成了帧播放和动作预设功能，可以快速制作出具有行走和攻击动作的游戏角色。

你需要提供一张包含所有游戏动作的雪碧图，这些动作将会被自动编号，如下所示：

适用平台

支持所有平台。

安装插件

需要安装 robot 插件才能使用，点此访问 Github 仓库。

npm

npm install @leafer-in/robot

pnpm

pnpm add @leafer-in/robot

yarn

yarn add @leafer-in/robot

bun

bun add @leafer-in/robot

通过 script 标签引入

通过全局变量 LeaferIN.robot 访问插件内部功能。

robot.min

<script src="https://unpkg.com/@leafer-in/robot@1.0.5/dist/robot.min.js"></script>
<script>
  const { Robot } = LeaferIN.robot
</script>

robot

<script src="https://unpkg.com/@leafer-in/robot@1.0.5/dist/robot.js"></script>
<script>
  const { Robot } = LeaferIN.robot
</script>

https://unpkg.com 无法访问时，可替换为 https://cdn.jsdelivr.net/npm

体验

按住方向键，移动箭头试试～

import { Leafer, KeyEvent } from 'leafer-ui'
import { Robot } from '@leafer-in/robot'

const leafer = new Leafer({ view: window })

const robot = new Robot({
    robot: { url: '/image/arrows.png', size: { width: 100, height: 100 }, total: 20 },
    actions: {  // 预设游戏动作（通过动作帧）
        up: 0, // 静止向上的箭头（ 编号为0的动作帧）
        right: 5,
        down: 10,
        left: 15,
        arrowUp: [0, 1, 2, 3, 4], // 动态向上的箭头（循环播放编号为 1-4 的动作帧）
        arrowRight: [5, 6, 7, 8, 9],
        arrowDown: [10, 11, 12, 13, 14],
        arrowLeft: [15, 16, 17, 18, 19]
    },
    action: 'right' // 设置动作：静止向右的箭头
})

leafer.add(robot)

// 监听方向键进行交互

let speed = 5

leafer.on(KeyEvent.DOWN, (e: KeyEvent) => {
    speed++
    switch (e.code) { // 动态的方向箭头
        case 'ArrowUp':
            robot.action = 'arrowUp'
            robot.y -= speed
            break
        case 'ArrowDown':
            robot.action = 'arrowDown'
            robot.y += speed
            break
        case 'ArrowLeft':
            robot.action = 'arrowLeft'
            robot.x -= speed
            break
        case 'ArrowRight':
            robot.action = 'arrowRight'
            robot.x += speed
            break
    }
})

leafer.on(KeyEvent.UP, (e: KeyEvent) => {
    speed = 5
    switch (e.code) { // 静态的方向箭头
        case 'ArrowUp':
            robot.action = 'up'
            break
        case 'ArrowDown':
            robot.action = 'down'
            break
        case 'ArrowLeft':
            robot.action = 'left'
            break
        case 'ArrowRight':
            robot.action = 'right'
            break
    }
})

下一步

Robot 元素