This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
component:inventory_controller:zh [2023/11/15 14:12] hfsr [Component: Inventory Controller] |
component:inventory_controller:zh [2023/12/27 02:08] (current) hfsr [组件：物品栏控制器] |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| 此组件由[[item:inventory_controller_upgrade:zh|物品栏控制器升级]]提供。 | 此组件由[[item:inventory_controller_upgrade:zh|物品栏控制器升级]]提供。 | ||
| - | 有了API，机器人可以接收有关物品或物品栏的额外信息，并且可以向指定槽位放入物品或从中取出物品。 | + | 有了此API，机器人可以接收有关物品或物品栏的额外信息，并且可以向指定槽位放入物品或从中取出物品。 |
| 大多数操作所需的方向（side）遵循[[api:sides:zh|Sides(方向面) API]]中的方向。若不指定方向或指定错误的方向，函数通常会报错。要与机器人自身的物品栏互动需要使用`back`方向，这也使得机器人无法与在其身后的物品容器互动。机器人也不能访问它们的左右两边。综上，你只能与机器人前方、上方或下方的物品容器互动。 | 大多数操作所需的方向（side）遵循[[api:sides:zh|Sides(方向面) API]]中的方向。若不指定方向或指定错误的方向，函数通常会报错。要与机器人自身的物品栏互动需要使用`back`方向，这也使得机器人无法与在其身后的物品容器互动。机器人也不能访问它们的左右两边。综上，你只能与机器人前方、上方或下方的物品容器互动。 | ||
| Line 39: | Line 39: | ||
| **count** - 要转移多少物品。 | **count** - 要转移多少物品。 | ||
| **返回值：**若至少移动了一个物品则返回`true`，否则返回`false`与报错信息。 | **返回值：**若至少移动了一个物品则返回`true`，否则返回`false`与报错信息。 | ||
| - | 请注意此函数中机器人不能将物品放入自身物品栏，试图这样做会抛出错误。你需要使用[[api:robot:zh|Robot(机器人) API]]中的`robot.transferTo`函数来进行此操作。 | + | 请注意此函数中机器人不能将物品放入自身物品栏，试图这样做会抛出错误。你需要使用[[api:robot:zh|Robot(机器人) API]]中的`robot.transferTo`函数来进行此操作。 |
| + | \\ | ||
| - `suckFromSlot(side:number, slot:number[, count:number]):boolean` | - `suckFromSlot(side:number, slot:number[, count:number]):boolean` | ||
| - | 从指定方向处物品容器的指定槽位获取物品，转移到机器人物品栏的当前选中槽位，至多指定数量个。 | + | 从指定方向处物品容器的指定槽位获取物品，转移到机器人物品栏的当前选中槽位，至多指定数量个。 |
| - | **side** - 某个有效方向。 | + | **side** - 某个有效方向。 |
| - | **slot** - 用于获取物品的槽位。 | + | **slot** - 用于获取物品的槽位。 |
| - | **count** - 要转移多少物品。 | + | **count** - 要转移多少物品。 |
| **返回值：**若至少移动了一个物品则返回`true`，否则返回`false`。 | **返回值：**若至少移动了一个物品则返回`true`，否则返回`false`。 | ||
| 若机器人物品栏的当前选中槽位被占用，则传入的物品会被合并到物品栏中的相同物品堆中，或移动到下一个空闲槽位（有的话）。若没有可用槽位则操作会失败。 | 若机器人物品栏的当前选中槽位被占用，则传入的物品会被合并到物品栏中的相同物品堆中，或移动到下一个空闲槽位（有的话）。若没有可用槽位则操作会失败。 | ||
| Line 76: | Line 77: | ||
| 输出[[http://ocdoc.cil.li/api:robot:zh|slot]]所指示位置的物品元数据。 | 输出[[http://ocdoc.cil.li/api:robot:zh|slot]]所指示位置的物品元数据。 | ||
| + | |||
| ```lua | ```lua | ||
| Line 91: | Line 93: | ||
| print("Slot " .. slot .. " is empty") | print("Slot " .. slot .. " is empty") | ||
| end | end | ||
| - | `` | + | ``` |
| ` | ` | ||
| 目录 | 目录 | ||
| --------------------------- | --------------------------- | ||
| {{page>component:contents:zh&noheader&noeditbutton&nouser&nofooter}} | {{page>component:contents:zh&noheader&noeditbutton&nouser&nofooter}} | ||