.svg){kind=small}
“移动端配置按键”是什么？
“移动端配置按键”扩展是 Gandi IDE 提供的一个扩展功能，该扩展可以为作品添加一套移动端（手机、平板）的控制按键，让你的作品在移动端依然可以畅玩
可以实现什么样的效果？
如何使用？
“移动端配置按键”分为 2 个模块，分别为：
模块 | 功能 |
移动端按键配置 | 自定义工程按键在手机或者平板上的展示位置以及大小 |
移动端按键积木控制 | 控制按键在移动端的显示以及隐藏，同时可为作品添加 2 个遥杆 |
自定义按键添加入口
创作作品过程中，一共有 2 个地方可以为作品添加移动端按键
- 直接在扩展中添加自定义按键
- 在 Gandi 编辑器中添加“移动端配置按键”扩展
- 在代码编辑页，查看扩展
- 点击积木上方的“自定义移动端按键”按钮
- 在作品发布时添加自定义按键
若在编辑过程中未配置按键，在发布阶段可选择“自定义按键”进行配置
配置的按键仅会在移动端（手机、平板等移动端设备）上生效，电脑端运行程序时不会显示配置的按键
自定义按键弹框
- 进入自定义按键弹框后，系统会自动识别当前作品中添加过的按键并展示在最左侧
- 首次设置按键，系统将会使用默认布局，用户可自定义修改
- 点击按键前方选框，即可在移动端添加或取消按键
- 按键支持移动位置（只可在绿色区域内移动）、更改大小以及上传按键图片
控制积木
- 【显示移动端按键】&【隐藏移动端按键】
很多作品在移动端运行时并非一直需要操作按键（刚开始运行程序，显示菜单时不需要展示操作按键；进入游戏后需要操作按键）这种情况下可使用下方 2 个积木控制移动端按键显示或隐藏
1. 移动端所有的按键操作仅在移动端生效，电脑端无效
2. 按键在移动端默认显示
- 遥杆事件积木
支持为作品在移动端添加最多 2 个遥杆，当所选遥杆发生偏移时，将会通过 direction 和 distance 2 个值积木返回遥杆数据
参数 | 含义 | 返回值范围 |
direction | 遥杆操作的方向 | 返回值范围为 -180 ~180，方向同 Scratch 方向一致 |
distance | 遥杆距离中心位置的距离 | 返回值 0 ~ 100，0 表示遥杆处于中心位置，未移动；100 表示遥杆距离中心位置已经到达最大限度 |
当工程中使用了当前事件积木，在按键自定义配置页面按键选项中才会展示遥杆选项
- 遥杆数据返回值
可通过以下积木读取所选遥杆当前的控制参数
- 玩家设备检测
可以判断玩家当前使用的设备类型（电脑、平板、手机），创作者可根据设备控制作品中的元素的展示
如：MMO 枪战中，摇杆遮挡了作品的其他功能按键，创作者就可以判断如果当前玩家是手机或平板，那么可以将功能按键展示到其他位置，电脑端依然展示在左右下角（此处手动 @ Arkos）
