Remove poll/unpoll from presence
This commit is contained in:
parent
05a2427c73
commit
e7aed3da26
2 changed files with 2 additions and 37 deletions
|
@ -16,8 +16,6 @@ type: object
|
||||||
title: Presence EDU
|
title: Presence EDU
|
||||||
description: |-
|
description: |-
|
||||||
An EDU representing presence updates for users of the sending homeserver.
|
An EDU representing presence updates for users of the sending homeserver.
|
||||||
Can also be used to request additional presence updates for users of the
|
|
||||||
receiving homeserver.
|
|
||||||
allOf:
|
allOf:
|
||||||
- $ref: ../edu.yaml
|
- $ref: ../edu.yaml
|
||||||
- type: object
|
- type: object
|
||||||
|
@ -35,7 +33,7 @@ allOf:
|
||||||
type: array
|
type: array
|
||||||
description: |-
|
description: |-
|
||||||
A list of presence updates that the receiving server is likely
|
A list of presence updates that the receiving server is likely
|
||||||
to be interested in, or is subscribed to.
|
to be interested in.
|
||||||
items:
|
items:
|
||||||
type: object
|
type: object
|
||||||
title: User Presence Update
|
title: User Presence Update
|
||||||
|
@ -67,31 +65,4 @@ allOf:
|
||||||
Defaults to false.
|
Defaults to false.
|
||||||
example: true
|
example: true
|
||||||
required: ['user_id', 'presence', 'last_active_ago']
|
required: ['user_id', 'presence', 'last_active_ago']
|
||||||
poll:
|
|
||||||
type: array
|
|
||||||
description: |-
|
|
||||||
New user IDs that the sending server would like to subscribe to the
|
|
||||||
presence of. The sending server should not include users it has already
|
|
||||||
requested to be subscribed to.
|
|
||||||
|
|
||||||
The receiving server should ensure the sending server has reasonable
|
|
||||||
interest in subscribing to the provided users. The receiver may ignore
|
|
||||||
a request to subscribe to a user the sender does not have reasonable
|
|
||||||
interest in. Reasonable interest may be residing in a room with the user,
|
|
||||||
being subscribed to a presence list, or some other requirement.
|
|
||||||
|
|
||||||
If non-empty, the receiving server should immediately send the presence
|
|
||||||
updates to the sender for the users requested.
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
example: ["@alice:elsewhere.org"]
|
|
||||||
unpoll:
|
|
||||||
type: array
|
|
||||||
description: |-
|
|
||||||
New user IDs the sending server is no longer interested in receiving
|
|
||||||
presence updates for. The sending server should not include users it
|
|
||||||
has previously requested to be unsubscribed from.
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
example: ["@bob:elsewhere.org"]
|
|
||||||
required: ['push']
|
required: ['push']
|
||||||
|
|
|
@ -843,12 +843,6 @@ would be interested in. This can include the receiving server sharing a room
|
||||||
with a given user, or a user on the receiving server has added one of the
|
with a given user, or a user on the receiving server has added one of the
|
||||||
sending server's users to their presence list.
|
sending server's users to their presence list.
|
||||||
|
|
||||||
Servers may also request additional users by including them in the ``poll``
|
|
||||||
array on an ``m.presence`` update. The receiving server may ignore users
|
|
||||||
requested in this array. The receiving server should maintain a list of
|
|
||||||
subscribed users for the sending server, which is appended to by the ``poll``
|
|
||||||
array and deleted from by the ``unpoll`` array.
|
|
||||||
|
|
||||||
.. TODO-doc
|
.. TODO-doc
|
||||||
- Explain the timing-based round-trip reduction mechanism for presence
|
- Explain the timing-based round-trip reduction mechanism for presence
|
||||||
messages
|
messages
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue