组件：导航
===================
此组件由[[item:navigation_upgrade: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: 信标标签			||


目录
----
{{page>component:contents:zh&noheader&noeditbutton&nouser&nofooter}}