https://ocr.michiyo.me/w/index.php?action=history&feed=atom&title=Component%2Fnavigation%2Fzh
Component/navigation/zh - Revision history
2026-08-24T15:34:37Z
Revision history for this page on the wiki
MediaWiki 1.43.9
https://ocr.michiyo.me/w/index.php?title=Component/navigation/zh&diff=1185&oldid=prev
imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li
2026-08-24T08:08:27Z
<p>Imported from legacy OpenComputers documentation at ocdoc.cil.li</p>
<p><b>New page</b></p><div>= 组件：导航 =<br />
<br />
此组件由[[Item/navigation upgrade/zh|导航升级]]提供。<br />
<br />
组件名：`navigation`。<br />
<br />
回调函数：<br />
<br />
* `getPosition(): number, number, number or nil, string`<br />
<br />
<pre>获取机器人当前的相对坐标，此坐标相对于合成升级时使用地图的中心点。请注意此升级可以与另一张地图一起重新合成，这样可以改变其参考原点。若机器人离开参考点太远（即超出用于合成升级的地图范围）则会返回`nil`与字符串`out of range`。 <br />
</pre><br />
<br />
* `getFacing(): number`<br />
<br />
<pre>获取机器人的当前朝向，取值为`sides`常量的其中之一。 <br />
</pre><br />
<br />
* `getRange(): number`<br />
<br />
<pre>获取升级的作用范围。若机器人相对原点的X或Z偏移量绝对值大于此结果，`getPosition()`函数将会执行失败。 <br />
</pre><br />
<br />
* `findWaypoints(range: number): table` <span class="underline">'''''注意：'''需要1.5.9以上版本的OpenComputers。''</span><br />
<br />
<pre>查找指定范围内的所有[[Block/waypoint/zh|路径点方块]]。此函数的返回值为内含第二层表的表。外层表为检测到的所有信标的编号索引。外层表的每个条目均为一个内层表，其中的每行都是对应信标的一个参数："position"、"redstone"、"label"。 <br />
</pre><br />
* `position`（位置）参数为一个数字索引的表，其中1为x，2为y，3为z。这些数字代表了导航组件到对应信标的相对距离，形式为方块坐标。<br />
* `redstone`（红石）参数为单个数字。代表当前输入路径点方块的红石信号强度。<br />
* `label`（标签）参数为一个字符串。代表了信标的标签。你可以右键单击信标以修改。 <br />
<br />
下面是上文所述表的格式样例，其中展示了一个信标的结果。<br />
<br />
{|<br />
! table: main<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
| table: 1<br />
| table: position<br />
| 1:<br />
| number: x轴距离<br />
|<br />
|-<br />
| :::<br />
| :::<br />
| 2:<br />
| number: y轴距离<br />
|<br />
|-<br />
| :::<br />
| :::<br />
| 3:<br />
| number: z轴距离<br />
|<br />
|-<br />
| :::<br />
| redstone<br />
|<br />
| number: 红石信号强度<br />
|<br />
|-<br />
| :::<br />
| label<br />
|<br />
| string: 信标标签<br />
|<br />
|}<br />
<br />
== 目录 ==<br />
<br />
{{:Component/contents/zh}}<br />
</div>
imported>OCDoc Import