Protocols/OSCAR/SNAC/OSERVICE IDLE NOTIFICATION: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
No edit summary
(Replaced content with "[https://gitlab.com/hollerith/cool/-/blob/main/docs/protocols/SNAC/OSERVICE/OSERVICE__IDLE_NOTIFICATION.md more]")
Tag: Replaced
Line 1: Line 1:
{{Protocols/OSCAR}}
[https://gitlab.com/hollerith/cool/-/blob/main/docs/protocols/SNAC/OSERVICE/OSERVICE__IDLE_NOTIFICATION.md more]
{{Protocols/OSCAR/SNAC/Stats
|origin={{Protocols/OSCAR/SNAC/OSERVICE__IDLE_NOTIFICATION/Origin}}
|name=OSERVICE__IDLE_NOTIFICATION
|id=0x0001, 0x0011
|service={{Protocols/OSCAR/Foodgroups/OSERVICE/Service}}
|status={{Protocols/OSCAR/Foodgroups/OSERVICE/Status}}
|version={{Protocols/OSCAR/Foodgroups/OSERVICE/Version}} }}
 
{{Protocols/OSCAR/SNAC/OSERVICE__IDLE_NOTIFICATION/Description}}
 
Notes from another:
<!--
        * A SNAC command used to set how long the user has been idle. This command
        * should only be sent once when the user becomes idle; the server will handle
        * increasing the amount of idle time as time progresses. When the user becomes
        * unidle, the command should be sent with an idle time value of zero
        *  (<code>SetIdleCmd.IDLETIME_NOT_IDLE</code>).
        * <br><br>
        * The idle time is sent in this command in terms of the number of seconds the
        * user has been idle, but when reported to buddies in a {@link snaccmd.FullUserInfo}, it is reported in minutes.
        *
        * @snac.src client
-->
 
A non-zero idleTime indicates that the user is idle and specifies the number of seconds since the user's last keyboard or mouse input. A zero idleTime indicates that the user is active. If the client is not capable of detecting the user's idle state it should not send this SNAC.
 
In order to prevent excessive load on the server, the client should not send this SNAC with a non-zero idleTime more often that once every 10 minutes. Once the server receives this SNAC it will automatically increment it as time goes by.
 
=== SNAC Header ===
{{Protocols/OSCAR/SNAC/Header
|foodgroup=00 01
|subgroup=00 11
|flags=00 00
|reqid=00 00 00 00}}
 
=== SNAC Data ===
{| class="wikitable"
! Name
! Type
! Notes
|-
| idleTime
| uint32 (dword)
| Client's idle time when changing states
|}
 
=== From Aleksandr Shutko: SNAC(01,11) client set idle time command SNAC(01,11) OSERVICE__IDLE_NOTIFICATION  ===
 
<table width=640 cellSpacing=0 cellPadding=0 border=0>
<tr>
<td>
<br>
Set idle information. If idle_secs field is 0 then the user isn't idle at all and
the server informs all watching clients to remove idletime-string in their tooltip
of my uin-item. If idle_secs field is greater then 0 then the user has already been
idle for idle_secs number of seconds. The server will automatically keep
incrementing this number, so do not repeatedly call with new idle times.
<br><br>
 
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td bgcolor=#E9E9E9>
 
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=169>&nbsp;00 01</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=55%>SNAC family</td>
</tr>
<tr>
<td>&nbsp;00 11</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>SNAC subtype</td>
</tr>
<tr>
<td>&nbsp;00 00</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>SNAC flags</td>
</tr>
<tr>
<td>&nbsp;xx xx xx xx</td>
<td>&nbsp;</td>
<td>dword</td>
<td>&nbsp;</td>
<td>SNAC request-id</td>
</tr>
</table>
 
</td></tr>
<tr><td bgcolor=#E9E9E9>
 
<table width=640 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=169>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=55%>idle_secs</td>
</tr>
</table>
 
</td></tr></table>
</td></tr></table>
</td></tr></table>
 
<br>Example SNAC dump with flap header:
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr>
<td bgcolor=#E9E9E9>
<font size=3><pre style="font-size: 13px">
 
2A 02 E5 65 00 12 00 01  00 1F 00 00 82 E8 D1 D1 *..e............
00 00 00 3C                                      ....
 
</pre></font>
</td></tr></table>
</td></tr></table>
 
 
=== OSERVICE SNACs ===
{{Protocols/OSCAR/Foodgroups/OSERVICE/SNACs/Simple}}
 
[[Category:With_Contrib]]
[[Category:Stub]]
[[Category:AOL]]
[[Category:AIM]]
[[Category:Protocols/OSCAR]]
[[Category:Protocols/OSCAR/SNACs]]
[[Category:Work_In_Progress]]
[[Category:Has_Notes]]

Revision as of 17:42, 10 February 2026