feat(audio-rooms): host hand-raise queue UI (T1 #5)

Surfaces audience members who raised their hand (kind-10312
presence with `hand=1`) and gives the host a one-tap "Approve"
button that promotes them to SPEAKER via
RoomParticipantActions.setRole.

  HandRaiseQueueSection — Compose section visible host-only.
  Filters the VM's `presences` map to entries where
  handRaised=true AND the pubkey isn't already a host / moderator /
  speaker (they wouldn't have raised their hand if they could
  already speak). Hidden when the queue is empty so a quiet room
  doesn't gain a placeholder.

  AudioRoomFullScreen — gates the section on `isHost` and stitches
  it in below the audience row.

  Strings: `audio_room_hand_raise_queue_title`,
           `audio_room_hand_raise_approve`.

Approve flow:
  presence.hand=1 → RoomParticipantActions.setRole(event, target,
  ROLE.SPEAKER) → account.signAndComputeBroadcast → relay sees
  same `d`-tag → kind-30312 replaced. The promoted user's
  participant tag now reports canSpeak() == true; their VM's
  startBroadcast() gating in commons unblocks them automatically
  on the next render.
This commit is contained in:
Claude
2026-04-26 22:41:54 +00:00
parent 6d1299c72a
commit be227fc966
3 changed files with 130 additions and 0 deletions
@@ -190,6 +190,14 @@ internal fun AudioRoomFullScreen(
)
}
if (isHost) {
HandRaiseQueueSection(
event = event,
viewModel = viewModel,
accountViewModel = accountViewModel,
)
}
ConnectionRow(viewModel = viewModel, ui = ui)
val myPubkey = accountViewModel.account.signer.pubKey
@@ -0,0 +1,120 @@
/*
* Copyright (c) 2025 Vitor Pamplona
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
* Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
* AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
package com.vitorpamplona.amethyst.ui.screen.loggedIn.audiorooms.room
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.width
import androidx.compose.material3.Button
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.collectAsState
import androidx.compose.runtime.getValue
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import com.vitorpamplona.amethyst.R
import com.vitorpamplona.amethyst.commons.viewmodels.AudioRoomViewModel
import com.vitorpamplona.amethyst.ui.note.ClickableUserPicture
import com.vitorpamplona.amethyst.ui.screen.loggedIn.AccountViewModel
import com.vitorpamplona.amethyst.ui.stringRes
import com.vitorpamplona.amethyst.ui.theme.Size35dp
import com.vitorpamplona.quartz.nip53LiveActivities.meetingSpaces.MeetingSpaceEvent
import com.vitorpamplona.quartz.nip53LiveActivities.streaming.tags.ROLE
import kotlinx.coroutines.launch
/**
* Host-only queue of audience members whose latest kind-10312
* presence has `hand=1` AND who aren't already a host / moderator /
* speaker (they wouldn't have raised their hand if they could
* already speak). Each row has an "Approve" button that promotes
* the user to SPEAKER via [RoomParticipantActions.setRole].
*
* Hidden when the queue is empty so it doesn't take up vertical
* space on a quiet room.
*
* Visibility gating to host-only is the caller's responsibility.
*/
@Composable
internal fun HandRaiseQueueSection(
event: MeetingSpaceEvent,
viewModel: AudioRoomViewModel,
accountViewModel: AccountViewModel,
modifier: Modifier = Modifier,
) {
val presences by viewModel.presences.collectAsState()
val onStageKeys =
event
.participants()
.filter { it.canSpeak() }
.map { it.pubKey }
.toSet()
val hands =
presences.values
.filter { it.handRaised && it.pubkey !in onStageKeys }
.sortedBy { it.updatedAtSec }
if (hands.isEmpty()) return
val scope = rememberCoroutineScope()
Column(modifier = modifier.fillMaxWidth().padding(top = 12.dp)) {
Text(
text = stringRes(R.string.audio_room_hand_raise_queue_title),
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
hands.forEach { hand ->
Row(
modifier = Modifier.fillMaxWidth().padding(top = 6.dp),
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(8.dp),
) {
ClickableUserPicture(
baseUserHex = hand.pubkey,
size = Size35dp,
accountViewModel = accountViewModel,
)
Text(
text = hand.pubkey.take(8),
style = MaterialTheme.typography.bodyMedium,
modifier = Modifier.weight(1f),
)
Spacer(Modifier.width(4.dp))
Button(
onClick = {
scope.launch {
val template = RoomParticipantActions.setRole(event, hand.pubkey, ROLE.SPEAKER)
template?.let { runCatching { accountViewModel.account.signAndComputeBroadcast(it) } }
}
},
) {
Text(stringRes(R.string.audio_room_hand_raise_approve))
}
}
}
}
}
+2
View File
@@ -534,6 +534,8 @@
<string name="audio_room_edit_save">Save</string>
<string name="audio_room_close_action">Close room</string>
<string name="audio_room_overflow_menu">Room actions</string>
<string name="audio_room_hand_raise_queue_title">Raised hands</string>
<string name="audio_room_hand_raise_approve">Approve</string>
<string name="audio_room_create_fab">Start space</string>
<string name="audio_room_create_title">Start a new audio room</string>
<string name="audio_room_create_field_room">Room name</string>