This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
component:computer:zh [2023/10/21 17:02] hfsr [Component: Computer] |
component:computer:zh [2023/12/10 15:15] (current) hfsr [组件:电脑] |
||
---|---|---|---|
Line 1: | Line 1: | ||
组件:电脑 | 组件:电脑 | ||
================== | ================== | ||
- | 电脑提供了许多API回调函数。请注意这些函数只可以被电脑自身或其直接邻居(即与此电脑存在共面的电脑)调用。还请注意因为机器人不能与外界组件交互,它们也就不能关闭/开启电脑或查询其属性,不过电脑可以与位于它们旁边的机器人交互。 | + | 电脑提供了许多API回调。请注意这些函数只可以被电脑自身或与其直接相邻者(即与此电脑共面的电脑)调用。还请注意因为机器人不能与外界组件交互,它们也就不能关闭/开启电脑或查询其属性,不过电脑可以与其旁边的机器人交互。 |
- | + | ||
- | 组件名:`computer`。 | + | 组件名:`computer`。 |
- | + | ||
- | 回调函数: | + | 回调函数: |
- `start(): boolean` | - `start(): boolean` | ||
- | 尝试启动电脑。成功时返回`true`,否则返回`false`。请注意若电脑已经在运行,此函数也会返回`false`。若电脑正在关机过程中,此函数会使电脑改为重启。 | + | 尝试开启电脑。成功时返回`true`,否则返回`false`。请注意若电脑已经在运行,此函数也会返回`false`。若电脑正在关机过程中,此函数会使电脑改为重启。 |
+ | \\ | ||
- `stop(): boolean` | - `stop(): boolean` | ||
- | 尝试关闭电脑。成功时返回`true`,否则返回`false`。若电脑已经关闭也会返回`false`。 | + | 尝试关闭电脑。成功时返回`true`,否则返回`false`。若电脑已经关闭也会返回`false`。 |
+ | \\ | ||
- `isRunning(): boolean` | - `isRunning(): boolean` | ||
- | 返回电脑当前是否正在运行。 | + | 返回电脑当前是否正在运行。 |
+ | \\ | ||
- `beep([frequency:number[, duration:number]])` | - `beep([frequency:number[, duration:number]])` | ||
- | 播放一个声音,可用于通过音频反馈提醒用户。支持20到2000Hz的声音频率,长度最大为5秒。 | + | 播放一个声音,可用于以音频反馈的形式提醒用户。支持20到2000Hz的声音频率(`frequency`),长度(`duration`)最大为5秒。 |
+ | \\ | ||
- `getDeviceInfo(): table` | - `getDeviceInfo(): table` | ||
- | 返回包含设备信息的表。请注意此函数特定于架构,某些架构可能完全不会引入此函数。 | + | 返回包含设备信息的表。请注意此函数特定于架构,某些架构可能完全不会引入此函数。 |
+ | \\ | ||
- `crash(reason: string)` | - `crash(reason: string)` | ||
- | 尝试以指定原因崩溃电脑。 | + | 尝试以指定原因崩溃电脑。 |
+ | \\ | ||
- `getArchitecture(): string` | - `getArchitecture(): string` | ||
- | 返回电脑的当前架构。 | + | 返回电脑的当前架构。 |
+ | \\ | ||
- `isRobot(): boolean` | - `isRobot(): boolean` | ||
- | 返回此电脑是否为机器人。 | + | 返回此电脑是否为机器人。 |
- | + | \\ | |
使用例: | 使用例: | ||
+ | |||
```lua | ```lua | ||
local component = require("component") | local component = require("component") | ||
- | local c = component.computer -- 获取首选电脑组件,例如自身 | + | local c = component.computer --获取首选电脑组件,例如自身 |
- | print(c.isRunning()) -- 如果是这台电脑那当然为true | + | print(c.isRunning()) --如果c是这台电脑那当然为true |
- | c.stop() -- 大体相当于computer.shutdown(),如果是这台电脑的话 | + | c.stop() --如果c是这台电脑的话,大体相当于computer.shutdown(), |
``` | ``` | ||