Remove poll/unpoll from presence

pull/977/head
Travis Ralston 6 years ago
parent 05a2427c73
commit e7aed3da26

@ -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']

@ -841,13 +841,7 @@ EDUs. There are no PDUs or Federation Queries involved.
Servers should only send presence updates for users that the receiving server Servers should only send presence updates for users that the receiving server
would be interested in. This can include the receiving server sharing a room 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

Loading…
Cancel
Save