组件：导航

此组件由导航升级提供。

组件名：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。

  查找指定范围内的所有路径点方块。此函数的返回值为内含第二层表的表。外层表为检测到的所有信标的编号索引。外层表的每个条目均为一个内层表，其中的每行都是对应信标的一个参数：“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: 信标标签