Dermot Duffy
85d6811761
The microphone is connected when a call needs it and released the moment that call ends, so the browser stops reporting it as in use at hangup rather than `disconnect_seconds` later. Existing configurations are migrated automatically by the visual editor. - Closes: #2681 BREAKING CHANGE: `live.microphone.disconnect_seconds` is removed. The microphone is released when a call ends, so there is no idle countdown to configure. Use `live.microphone.always_connected` to hold it open instead. BREAKING CHANGE: The `microphone_connect` and `microphone_disconnect` actions are removed. The card owns the microphone lifecycle; `microphone_mute` and `microphone_unmute` remain. BREAKING CHANGE: `call` is removed from `live.microphone.auto_mute`, whose default is now `[]`. The microphone is muted when a call ends regardless of this option. BREAKING CHANGE: `microphone_unmute` has no effect outside a call. Nothing carries the audio at any other time, so the request is ignored rather than opening the microphone.
71 lines
2.6 KiB
Plaintext
71 lines
2.6 KiB
Plaintext
@startuml
|
|
skinparam backgroundColor white
|
|
|
|
actor User
|
|
participant "Call" as Card
|
|
participant Microphone as Mic
|
|
actor Guest
|
|
|
|
opt <color:#43a047>**""live.microphone.always_connected""**</color> is enabled
|
|
Card -> Mic : Microphone connection attempted (muted)
|
|
note over Mic : Connected at card load, before (and independent of) any call
|
|
Mic --> User : Microphone access granted
|
|
end
|
|
|
|
alt Outbound call
|
|
User -> Card : Start a call
|
|
note over User, Card
|
|
Via Call menu button or <color:#43a047>**""call_start""**</color> action.
|
|
Needs a camera that supports 2-way audio
|
|
end note
|
|
else Inbound call
|
|
Guest -> Card : Rings
|
|
note over Card
|
|
Via a <color:#43a047>**""view.triggers.actions.trigger: call""**</color> trigger, e.g. a doorbell.
|
|
The card rings (<color:#43a047>**""live.controls.call.ringtone""**</color>) until answered,
|
|
rejected, or <color:#43a047>**""live.controls.call.unanswered_timeout_seconds""**</color> elapses
|
|
end note
|
|
User -> Card : Answer the call
|
|
end
|
|
|
|
opt <color:#43a047>**""live.microphone.always_connected""**</color> not enabled
|
|
Card -> Mic : Microphone connection attempted (muted)
|
|
note over Mic : Stays muted by default (<color:#43a047>**""live.microphone.auto_unmute""**</color>)
|
|
Mic --> User : Microphone access granted
|
|
end
|
|
|
|
note over User, Mic
|
|
The microphone is connected when the call is answered -- immediately
|
|
for an outbound call. An inbound call rings without it, so a doorbell
|
|
can ring even where microphone access needs a tap to be granted
|
|
end note
|
|
|
|
Card --> User : You hear the caller
|
|
note over Card
|
|
Inbound audio unmutes if configured (<color:#43a047>**""live.auto_unmute""**</color>)
|
|
Menu, status bar & next/previous hide (<color:#43a047>**""auto_hide""**</color>)
|
|
Camera navigation is locked (<color:#43a047>**""live.controls.call.lock""**</color>)
|
|
end note
|
|
|
|
User -> Mic : Unmute to talk
|
|
note over Mic : List 'call' in <color:#43a047>**""live.microphone.auto_unmute""**</color> to unmute automatically
|
|
|
|
loop Until the call ends
|
|
User -[#red]> Guest : Talking
|
|
Guest -[#red]-> User : Responding
|
|
end
|
|
|
|
User -> Card : End the call
|
|
note over User, Card
|
|
Via Hang-up button, <color:#43a047>**""call_end""**</color> action, or -- when
|
|
<color:#43a047>**""live.controls.call.lock""**</color> is disabled -- navigating away
|
|
end note
|
|
|
|
Card --> User : Inbound audio mutes (<color:#43a047>**""live.auto_mute""**</color>)
|
|
Card -> Mic : Microphone mutes and disconnects
|
|
note over Mic
|
|
The browser stops reporting the microphone as in use, unless
|
|
<color:#43a047>**""live.microphone.always_connected""**</color> holds it open
|
|
end note
|
|
@enduml
|