Michiyo: Clean up Markdown artifacts from DokuWiki migration

2026-08-24T20:27:42Z

Clean up Markdown artifacts from DokuWiki migration

← Older revision		Revision as of 20:27, 24 August 2026
Line 3:		Line 3:
	此组件由[[Item/navigation upgrade/zh\|导航升级]]提供。		此组件由[[Item/navigation upgrade/zh\|导航升级]]提供。

	组件名：`navigation`。		组件名：<code>navigation</code>。

	回调函数：		回调函数：

	* `getPosition(): number, number, number or nil, string`		* <code>getPosition(): number, number, number or nil, string</code>

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

	* `getFacing(): number`		* <code>getFacing(): number</code>

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

	* `getRange(): number`		* <code>getRange(): number</code>

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

	* `findWaypoints(range: number): table` <span class="underline">'''''注意：'''需要1.5.9以上版本的OpenComputers。''</span>		* <code>findWaypoints(range: number): table</code> <span class="underline">'''''注意：'''需要1.5.9以上版本的OpenComputers。''</span>

	<pre>查找指定范围内的所有[[Block/waypoint/zh\|路径点方块]]。此函数的返回值为内含第二层表的表。外层表为检测到的所有信标的编号索引。外层表的每个条目均为一个内层表，其中的每行都是对应信标的一个参数："position"、"redstone"、"label"。		<pre>查找指定范围内的所有[[Block/waypoint/zh\|路径点方块]]。此函数的返回值为内含第二层表的表。外层表为检测到的所有信标的编号索引。外层表的每个条目均为一个内层表，其中的每行都是对应信标的一个参数："position"、"redstone"、"label"。
	</pre>		</pre>
	* `position`（位置）参数为一个数字索引的表，其中1为x，2为y，3为z。这些数字代表了导航组件到对应信标的相对距离，形式为方块坐标。		* <code>position</code>（位置）参数为一个数字索引的表，其中1为x，2为y，3为z。这些数字代表了导航组件到对应信标的相对距离，形式为方块坐标。
	* `redstone`（红石）参数为单个数字。代表当前输入路径点方块的红石信号强度。		* <code>redstone</code>（红石）参数为单个数字。代表当前输入路径点方块的红石信号强度。
	* `label`（标签）参数为一个字符串。代表了信标的标签。你可以右键单击信标以修改。		* <code>label</code>（标签）参数为一个字符串。代表了信标的标签。你可以右键单击信标以修改。

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

	{{:Component/contents/zh}}		{{:Component/contents/zh}}

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li

2026-08-24T08:08:27Z

Imported from legacy OpenComputers documentation at ocdoc.cil.li

New page

= 组件：导航 =

此组件由[[Item/navigation upgrade/zh|导航升级]]提供。

组件名：`navigation`。

回调函数：

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

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

* `getFacing(): number`

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

* `getRange(): number`

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

* `findWaypoints(range: number): table` <span class="underline">'''''注意：'''需要1.5.9以上版本的OpenComputers。''</span>

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

== 目录 ==

{{:Component/contents/zh}}

Component/navigation/zh - Revision history

Michiyo: Clean up Markdown artifacts from DokuWiki migration

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li