Component/navigation/zh

组件：导航

此组件由导航升级提供。

组件名：`navigation`。

回调函数：

• `getPosition(): number, number, number or nil, string`

获取机器人当前的相对坐标，此坐标相对于合成升级时使用地图的中心点。请注意此升级可以与另一张地图一起重新合成，这样可以改变其参考原点。若机器人离开参考点太远（即超出用于合成升级的地图范围）则会返回`nil`与字符串`out of range`。  

• `getFacing(): number`

获取机器人的当前朝向，取值为`sides`常量的其中之一。  

• `getRange(): number`

获取升级的作用范围。若机器人相对原点的X或Z偏移量绝对值大于此结果，`getPosition()`函数将会执行失败。  

• `findWaypoints(range: number): table` 注意：需要1.5.9以上版本的OpenComputers。

查找指定范围内的所有[[Block/waypoint/zh|路径点方块]]。此函数的返回值为内含第二层表的表。外层表为检测到的所有信标的编号索引。外层表的每个条目均为一个内层表，其中的每行都是对应信标的一个参数："position"、"redstone"、"label"。  

• `position`（位置）参数为一个数字索引的表，其中1为x，2为y，3为z。这些数字代表了导航组件到对应信标的相对距离，形式为方块坐标。
• `redstone`（红石）参数为单个数字。代表当前输入路径点方块的红石信号强度。
• `label`（标签）参数为一个字符串。代表了信标的标签。你可以右键单击信标以修改。

下面是上文所述表的格式样例，其中展示了一个信标的结果。

table: main
table: 1	table: position	1:	number: x轴距离
:::	:::	2:	number: y轴距离
:::	:::	3:	number: z轴距离
:::	redstone		number: 红石信号强度
:::	label		string: 信标标签

目录

< 100% 15% 15% >
组件API		3D打印机 - 抽象总线 - 无线接入点 - 区块加载器 - 电脑 - 合成 - 数据卡 - 数据库 - 调试 - 无人机 - 驱动器 - EEPROM - 经验 - 文件系统 - 发电机 - 地质分析仪 - GPU - 全息投影仪 - 因特网 - 物品栏控制器 - 拴绳 - 微控制器 - 调制解调器 - 运动传感器 - 导航 - 网络拆分器 - 活塞 - 红石 - 运动红石机构 - 机器人 - 屏幕 - 告示牌 - 储罐控制器 - 牵引光束 - 转运器 - 隧道 - 世界传感器
:::	其它	访问组件 - 信号
:::	模组联动	应用能源