From 2c6ddafb43cc92595cc24e307a95b1ed9d3ab8d8 Mon Sep 17 00:00:00 2001 From: Johannes Marbach Date: Tue, 13 May 2025 16:09:12 +0200 Subject: [PATCH] Clarify the meaning of "public rooms" for call invites (#2106) --- .../client_server/newsfragments/2106.clarification | 1 + content/client-server-api/modules/voip_events.md | 12 +++++++----- 2 files changed, 8 insertions(+), 5 deletions(-) create mode 100644 changelogs/client_server/newsfragments/2106.clarification diff --git a/changelogs/client_server/newsfragments/2106.clarification b/changelogs/client_server/newsfragments/2106.clarification new file mode 100644 index 00000000..8a0dd00a --- /dev/null +++ b/changelogs/client_server/newsfragments/2106.clarification @@ -0,0 +1 @@ +"Public" rooms with respect to call invites are defined through their join rule. diff --git a/content/client-server-api/modules/voip_events.md b/content/client-server-api/modules/voip_events.md index 14b7d796..1c0bfd28 100644 --- a/content/client-server-api/modules/voip_events.md +++ b/content/client-server-api/modules/voip_events.md @@ -202,11 +202,13 @@ specific user, and should be set to the Matrix user ID of that user. Invites without an `invitee` field are defined to be intended for any member of the room other than the sender of the event. -Clients should consider an incoming call if they see a non-expired invite event where the `invitee` field is either -absent or equal to their user's Matrix ID, however they should evaluate whether or not to ring based on their -user's trust relationship with the callers and/or where the call was placed. As a starting point, it is -suggested that clients ignore call invites from users in public rooms. It is strongly recommended that -when clients do not ring for an incoming call invite, they still display the call invite in the room and +Clients should consider an incoming call if they see a non-expired invite event +where the `invitee` field is either absent or equal to their user's Matrix ID. +They should, however, evaluate whether or not to ring based on their user's trust +relationship with the callers and/or where the call was placed. As a starting +point, it is RECOMMENDED that clients ignore call invites in rooms with a +[join rule](#mroomjoin_rules) of `public`. When clients suppress ringing for an +incoming call invite, they SHOULD still display the call invite in the room and annotate that it was ignored. ##### Glare