Difference between revisions of "Rednet (API)"
From ComputerCraft Wiki
(anh em may cung voi nhin nap) |
(Undo revision 1728 by 91.121.152.54 (talk)) |
||
| Line 1: | Line 1: | ||
| − | + | The rednet API provides a simple computer networking model over RedPower bundled cables or the Wireless Modems of Computercraft 1.3.<br /> | |
| + | With the table below, 'side' refers to a string that represents a side of the computer ("front", "back", "left", "right", "bottom", "top"). All message sent with rednet are and must be strings. | ||
| + | |||
| + | ==Methods== | ||
| + | {| border="1" cellpadding="2" cellspacing="0" | ||
| + | !style="background:#EEE" width="200px"|Method name | ||
| + | !style="background:#EEE" width="*"|Description | ||
| + | !style="background:#EEE" width="80px"|Return type | ||
| + | |- | ||
| + | |[[rednet.open|rednet.open( side )]] | ||
| + | |Tells the computer that the side can be used for networking. | ||
| + | |nil | ||
| + | |- | ||
| + | |[[rednet.close]]( side ) | ||
| + | |Tells the computer that the side can no longer be used for networking. | ||
| + | |nil | ||
| + | |- | ||
| + | |[[rednet.announce]]() | ||
| + | |Broadcasts an empty rednet message. | ||
| + | |nil | ||
| + | |- | ||
| + | |[[rednet.send|rednet.send( receiverID,message )]] | ||
| + | |Sends a message to the computer using the opened sides. The receiver ID is the ID (number, not string) of the computer you're sending the message to. | ||
| + | |success | ||
| + | |- | ||
| + | |[[rednet.broadcast]]( message ) | ||
| + | |Sends the message to ALL connected and open computers. | ||
| + | |success | ||
| + | |- | ||
| + | |[[rednet.receive]]( timeout ) | ||
| + | |Waits until it received a rednet message or <var>timeout</var> has passed. Leave args empty to wait for a message forever. | ||
| + | |senderId, message, distance | ||
| + | |} | ||
| + | |||
| + | ==Events== | ||
| + | {| border="1" cellpadding="2" cellspacing="0" | ||
| + | !style="background:#EEE" width="200px"|Method name | ||
| + | !style="background:#EEE" width="*"|Description | ||
| + | !style="background:#EEE" width="*"|Parameters | ||
| + | |- | ||
| + | |rednet_message | ||
| + | |Fired when a rednet message is received (can be used as alternative for rednet.receive() | ||
| + | |senderId, message, distance | ||
| + | [[Category:APIs]] | ||
Revision as of 05:26, 3 June 2012
The rednet API provides a simple computer networking model over RedPower bundled cables or the Wireless Modems of Computercraft 1.3.
With the table below, 'side' refers to a string that represents a side of the computer ("front", "back", "left", "right", "bottom", "top"). All message sent with rednet are and must be strings.
Methods
| Method name | Description | Return type |
|---|---|---|
| rednet.open( side ) | Tells the computer that the side can be used for networking. | nil |
| rednet.close( side ) | Tells the computer that the side can no longer be used for networking. | nil |
| rednet.announce() | Broadcasts an empty rednet message. | nil |
| rednet.send( receiverID,message ) | Sends a message to the computer using the opened sides. The receiver ID is the ID (number, not string) of the computer you're sending the message to. | success |
| rednet.broadcast( message ) | Sends the message to ALL connected and open computers. | success |
| rednet.receive( timeout ) | Waits until it received a rednet message or timeout has passed. Leave args empty to wait for a message forever. | senderId, message, distance |
Events
| Method name | Description | Parameters |
|---|---|---|
| rednet_message | Fired when a rednet message is received (can be used as alternative for rednet.receive() | senderId, message, distance |
