diff options
author | irungentoo <irungentoo@gmail.com> | 2013-10-11 06:42:07 -0700 |
---|---|---|
committer | irungentoo <irungentoo@gmail.com> | 2013-10-11 06:42:07 -0700 |
commit | 31f5d7a8abacd045de1d55a0462d17d14095073c (patch) | |
tree | 31e93f067cf7f89b00d650f8f8fd7ba0fd640efb /toxcore/tox.h | |
parent | 77ec51085828c8dbe764030cbae7242994e590de (diff) | |
parent | 571412f911326a988d0d84019ea6a4ee8b49b17d (diff) |
Merge pull request #618 from nurupo/action-messages-with-id
Added message ids to action messages
Diffstat (limited to 'toxcore/tox.h')
-rw-r--r-- | toxcore/tox.h | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/toxcore/tox.h b/toxcore/tox.h index db4e6b57..39832073 100644 --- a/toxcore/tox.h +++ b/toxcore/tox.h | |||
@@ -209,7 +209,7 @@ int tox_friend_exists(Tox *tox, int friendnumber); | |||
209 | * return the message id if packet was successfully put into the send queue. | 209 | * return the message id if packet was successfully put into the send queue. |
210 | * return 0 if it was not. | 210 | * return 0 if it was not. |
211 | * | 211 | * |
212 | * You will want to retain the return value, it will be passed to your read receipt callback | 212 | * You will want to retain the return value, it will be passed to your read_receipt callback |
213 | * if one is received. | 213 | * if one is received. |
214 | * m_sendmessage_withid will send a message with the id of your choosing, | 214 | * m_sendmessage_withid will send a message with the id of your choosing, |
215 | * however we can generate an id for you by calling plain m_sendmessage. | 215 | * however we can generate an id for you by calling plain m_sendmessage. |
@@ -219,10 +219,16 @@ uint32_t tox_sendmessage_withid(Tox *tox, int friendnumber, uint32_t theid, uint | |||
219 | 219 | ||
220 | /* Send an action to an online friend. | 220 | /* Send an action to an online friend. |
221 | * | 221 | * |
222 | * return 1 if packet was successfully put into the send queue. | 222 | * return the message id if packet was successfully put into the send queue. |
223 | * return 0 if it was not. | 223 | * return 0 if it was not. |
224 | * | ||
225 | * You will want to retain the return value, it will be passed to your read_receipt callback | ||
226 | * if one is received. | ||
227 | * m_sendaction_withid will send an action message with the id of your choosing, | ||
228 | * however we can generate an id for you by calling plain m_sendaction. | ||
224 | */ | 229 | */ |
225 | int tox_sendaction(Tox *tox, int friendnumber, uint8_t *action, uint32_t length); | 230 | uint32_t tox_sendaction(Tox *tox, int friendnumber, uint8_t *action, uint32_t length); |
231 | uint32_t tox_sendaction_withid(Tox *tox, int friendnumber, uint32_t theid, uint8_t *action, uint32_t length); | ||
226 | 232 | ||
227 | /* Set friendnumber's nickname. | 233 | /* Set friendnumber's nickname. |
228 | * name must be a string of maximum MAX_NAME_LENGTH length. | 234 | * name must be a string of maximum MAX_NAME_LENGTH length. |