🐛 iOS user can't speak after role changes from listener to speaker

[Amjed201]

Description

I'm experiencing an issue with the 100ms SDK on iOS. Specifically, when a user's role changes from listener to speaker, the role change succeeds, but the user is unable to speak—even though the microphone permission is already granted.
However, if the user joins the room as a speaker from the start, everything works correctly. This issue only occurs on iOS; the same logic works perfectly fine on Android.

100ms Flutter Version

1.1.6

Steps to reproduce

1. Join any room as a listener
2. Change the role to a speaker

Expected results

The user should be able to speak naturally; the issue now happens only after switching roles.

Code example, screenshot, or link to a repository

My Full Voice Room Controller

Logs

Logs

<!-- Paste your logs here -->

Flutter Doctor output

Doctor output

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.1, on macOS 26.0.1 25A362 darwin-arm64, locale en-SA)
[!] Android toolchain - develop for Android devices (Android SDK version 36.1.0)
    ✗ cmdline-tools component is missing
      Run `path/to/sdkmanager --install "cmdline-tools;latest"`
      See https://developer.android.com/studio/command-line for more details.
    ✗ Android license status unknown.
      Run `flutter doctor --android-licenses` to accept the SDK licenses.
      See https://flutter.dev/to/macos-android-setup for more details.
[✓] Xcode - develop for iOS and macOS (Xcode 26.0.1)
[✗] Chrome - develop for the web (Cannot find Chrome executable at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome)
    ! Cannot find Chrome. Try setting CHROME_EXECUTABLE to a Chrome executable.
[✓] Android Studio (version 2025.1)
[✓] Connected device (4 available)
[✓] Network resources

[Amjed201]

final currentSpaceProvider = StateProvider<Space?>((ref) => null);
final currentSpaceRoleProvider = StateProvider<String?>((ref) => null);
final currentSpaceAuthTokenProvider = StateProvider<String?>((ref) => null);

final voiceRoomProvider =
StateNotifierProvider<VoiceRoomNotifier, VoiceRoomState>((ref) {
return VoiceRoomNotifier(ref);
});

class VoiceRoomNotifier extends StateNotifier
implements HMSUpdateListener, HMSActionResultListener {
VoiceRoomNotifier(this.ref) : super(VoiceRoomState.initial());
final Ref ref;

List peers = [];
Set speakingPeerIds = {};
Map<String, bool> raisedHandPeers = {};

HMSSDK? _hmsSDK;
late BuildContext _context;

Future initHMSSDK(BuildContext context) async {
_context = context;

await Permission.microphone.request();

if (_hmsSDK == null) {
  _hmsSDK = HMSSDK();
  _hmsSDK?.addUpdateListener(listener: this);
  final authToken = ref.watch(currentSpaceAuthTokenProvider);
  final userName =
      ref.read(loggedInTalentProvider)?.fullName ?? 'Guest User';
  final profilePic = ref.watch(loggedInTalentProvider)?.talentPicture;
  HMSConfig config = HMSConfig(
    authToken: authToken!,
    userName: userName,
    metaData: '{"avatar": "$profilePic"}',
  );
  final preBuilt = _hmsSDK?.isPrebuilt;
  if (preBuilt == false) await _hmsSDK?.build();

  final room = await _hmsSDK?.getRoom();

  if (room == null) await _hmsSDK?.join(config: config);
}

}

// void dispose() {
// super.dispose();
// _hmsSDK.leave();
// _hmsSDK.removeUpdateListener(listener: this);
// }

bool isMicOn = true;

void toggleMic() async {
await _hmsSDK?.toggleMicMuteState();
isMicOn = !isMicOn;
state = state.copyWith(isMicOn: isMicOn);
}

bool isLocalPeerMuted() {
final localPeer = getCurrentPeer();
if (localPeer != null) {
final audioTrack = localPeer.audioTrack;
if (audioTrack != null) {
return audioTrack.isMute;
}
}
return false; // Default to false if no local peer or audio track found
}
void leaveRoom({required BuildContext context, required Space space}) async {
hmsSDK?.leave().then(() {
ref.read(spaceActionsProvider.notifier).leave(space);
_hmsSDK?.removeUpdateListener(listener: this);
_hmsSDK = null;
ref.read(currentSpaceProvider.notifier).state = null;
Navigator.pop(context);
});
}

void endRoom({required BuildContext context, required Space space}) async {
hmsSDK?.endRoom(lock: true, reason: 'Space Finished').then(() {
ref.read(spaceActionsProvider.notifier).end(space);
_hmsSDK?.removeUpdateListener(listener: this);
_hmsSDK = null;
ref.read(currentSpaceProvider.notifier).state = null;
Navigator.pop(context);
});
}

void lowerHandAndChangeToListener(peer) async {
final roles = await _hmsSDK?.getRoles();

final listenerRole = roles?.firstWhere((r) => r.name == 'listener');

_hmsSDK?.lowerRemotePeerHand(forPeer: peer);
await _hmsSDK?.changeRoleOfPeer(
    force: true,
    forPeer: peer,
    toRole: listenerRole!,
    hmsActionResultListener: this);

}

void raiseLowerHand(peer) async {
if ((raisedHandPeers[peer.peerId] == true)) {
_hmsSDK?.lowerLocalPeerHand();
} else {
_hmsSDK?.raiseLocalPeerHand();
}
}

getCurrentPeer() {
return peers.where((peer) => peer.isLocal).firstOrNull;
}

bool _dialogOpened = false;

void showRaisedHandsDialog() {
final raisedHands =
peers.where((p) => raisedHandPeers[p.peerId] == true).toList();

if (raisedHands.isNotEmpty) {
  _dialogOpened = true;
  showDialog(
    context: _context,
    builder: (context) {
      return AlertDialog(
        backgroundColor: AppColors.white,
        title: Text(
          'Peers with Raised Hands',
          style:
              Theme.of(context).textTheme.bodyLarge?.copyWith(fontSize: 16),
        ),
        content: SizedBox(
          width: double.maxFinite,
          child: ListView.builder(
            shrinkWrap: true,
            itemCount: raisedHands.length,
            itemBuilder: (context, index) {
              final raisedPeer = raisedHands[index];
              return ListTile(
                title: Text(
                  raisedPeer.name,
                  style: Theme.of(context)
                      .textTheme
                      .bodyLarge
                      ?.copyWith(fontSize: 14),
                ),
                trailing: ElevatedButton(
                  onPressed: () async {
                    final roles = await _hmsSDK?.getRoles();

                    final speakerRole =
                        roles?.firstWhere((r) => r.name == 'speaker');
                    final listenerRole =
                        roles?.firstWhere((r) => r.name == 'listener');

                    _hmsSDK?.lowerRemotePeerHand(forPeer: raisedPeer);
                    await _hmsSDK?.changeRoleOfPeer(
                        force: true,
                        forPeer: raisedPeer,
                        toRole: raisedPeer?.role?.name == 'listener'
                            ? speakerRole!
                            : listenerRole!,
                        hmsActionResultListener: this);
                  },
                  child: Text(
                    'Promote',
                    style: Theme.of(context)
                        .textTheme
                        .bodyLarge
                        ?.copyWith(fontSize: 14),
                  ),
                ),
              );
            },
          ),
        ),
        actions: [
          TextButton(
            onPressed: () {
              _dialogOpened = false;
              Navigator.pop(context); // Close dialog
            },
            child: Text('Close'),
          ),
        ],
      );
    },
  );
} else {
  Helper.showToast('No current speakers requests');
}

}

@OverRide
void onJoin({required HMSRoom room}) async {
final role = ref.watch(currentSpaceRoleProvider) ?? 'listener';
try {
if (role == "listener") isMicOn = false;
peers.clear();
if (room.peers != null) {
peers.addAll(room.peers!);
}
state = state.copyWith(peers: peers, isMicOn: isMicOn);
ScaffoldMessenger.of(_context).showSnackBar(
SnackBar(
content: Text('Joined Room as ${role == 'moderator' ? 'host' : role}',
style: Theme.of(_context)
.textTheme
.bodyLarge
?.copyWith(fontSize: 15, color: AppColors.white)),
backgroundColor: AppColors.primary,
duration: Duration(seconds: 2),
),
);
} catch (e) {
print("[100ms] Error joining room: $e");
ScaffoldMessenger.of(_context).showSnackBar(
SnackBar(
content: Text('Failed to join room - $e',
style: Theme.of(_context)
.textTheme
.bodyLarge
?.copyWith(fontSize: 15, color: AppColors.white)),
backgroundColor: AppColors.red,
duration: Duration(seconds: 2),
),
);
}
}

@OverRide
void onPeerUpdate({required HMSPeer peer, required HMSPeerUpdate update}) {
final role = ref.watch(currentSpaceRoleProvider) ?? 'listener';
print("[100ms] Peer update: ${peer.name} - $update");

switch (update) {
  case HMSPeerUpdate.peerJoined:
    final exists = peers.any((p) => p.peerId == peer.peerId);
    if (!exists) {
      peers.add(peer);
    }
    state = state.copyWith(peers: peers);
    break;

  case HMSPeerUpdate.peerLeft:
    peers.removeWhere((p) => p.peerId == peer.peerId);
    state = state.copyWith(peers: peers);
    break;

  case HMSPeerUpdate.handRaiseUpdated:
    raisedHandPeers[peer.peerId] = peer.isHandRaised;

    state = state.copyWith(raisedHandPeers: raisedHandPeers);

    // Show dialog to moderator if hands are raised
    if (role == 'moderator') {
      showRaisedHandsDialog();
    }
    break;

  case HMSPeerUpdate.roleUpdated:
    if (ref.watch(currentSpaceRoleProvider) == 'moderator' &&
        peer.role.name == 'speaker') {
      _dialogOpened = false;
      Navigator.pop(_context);
    }
    peers.where((p) => p.peerId == peer.peerId).forEach((p) {
      peers[peers.indexOf(p)] = peer;
    });
    state = state.copyWith(peers: peers);
    print("[100ms] Peer role updated: ${peer.name} - ${peer.role.name}");
    break;
  default:
    // Handle other updates if needed
    break;
}

}

@OverRide
void onTrackUpdate({
required HMSTrack track,
required HMSTrackUpdate trackUpdate,
required HMSPeer peer,
}) {
print(
"[100ms] Track update: ${track.runtimeType} - ${track.trackId}, muted: ${track.isMute}, peer: ${peer.name}, update: $trackUpdate");

// Ensure we update the peer object with the latest track
final index = peers.indexWhere((p) => p.peerId == peer.peerId);
if (index != -1) {
  peers[index] = peer;
  peers = List.from(peers);
  state = state.copyWith(peers: peers);
}

// Optional: force audio playback allowed
if (track is HMSAudioTrack) {
  try {
    // track.setPlaybackAllowed(true);
    print("[100ms] Playback allowed set for track: ${track.trackId}");
  } catch (e) {
    print("[100ms] Could not set playback allowed: $e");
  }
}

}

@OverRide
void onHMSError({required HMSException error}) {
ScaffoldMessenger.of(_context).showSnackBar(
SnackBar(
content: Text('Failed to join room - ${error.message}',
style: Theme.of(_context)
.textTheme
.bodyLarge
?.copyWith(fontSize: 15, color: AppColors.white)),
backgroundColor: AppColors.red,
duration: Duration(seconds: 2),
),
);
}

@OverRide
void onRoomUpdate({required HMSRoom room, required HMSRoomUpdate update}) {
print("[100ms] Room update: $update");
print("[100ms] Room update: $update");
}

@OverRide
void onMessage({required HMSMessage message}) {}

@OverRide
void onRoleChangeRequest({required HMSRoleChangeRequest roleChangeRequest}) {}

@OverRide
void onUpdateSpeakers({required List updateSpeakers}) {
final ids = updateSpeakers
.map((speaker) => speaker.peer.peerId)
.whereType()
.toSet();

speakingPeerIds = ids;
state = state.copyWith(speakingPeerIds: speakingPeerIds);

}

@OverRide
void onReconnecting() {
print("[100ms] Reconnecting...");
ScaffoldMessenger.of(_context).showSnackBar(
SnackBar(
content: Text('Reconnecting...',
style: Theme.of(_context)
.textTheme
.bodyLarge
?.copyWith(fontSize: 15, color: AppColors.white)),
backgroundColor: AppColors.gray1,
duration: Duration(seconds: 2),
),
);
}

@OverRide
void onReconnected() {
print("[100ms] Reconnected successfully!");
ScaffoldMessenger.of(_context).showSnackBar(
SnackBar(
content: Text('Reconnected!',
style: Theme.of(_context)
.textTheme
.bodyLarge
?.copyWith(fontSize: 15, color: AppColors.white)),
backgroundColor: AppColors.primary,
duration: Duration(seconds: 2),
),
);
}

@OverRide
void onChangeTrackStateRequest(
{required HMSTrackChangeRequest hmsTrackChangeRequest}) {}

/// called when room is ended
@OverRide
void onRemovedFromRoom(
{required HMSPeerRemovedFromPeer hmsPeerRemovedFromPeer}) {
final space = ref.watch(currentSpaceProvider);
print("[100ms] Room closed by moderator");
showDialog(
context: _context,
barrierDismissible: false,
builder: (context) => AlertDialog(
backgroundColor: AppColors.white,
title: Text(
'Room Closed',
style: Theme.of(context).textTheme.bodyLarge?.copyWith(fontSize: 16),
),
content: Text(
'The room has been closed by the moderator.',
style: Theme.of(context).textTheme.labelLarge?.copyWith(fontSize: 16),
),
actions: [
TextButton(
onPressed: () {
ref.read(spaceActionsProvider.notifier).leave(space!);
Navigator.pop(context); // Close the dialog
Navigator.pop(context); // Navigate back
},
child: Text(
'OK',
style:
Theme.of(context).textTheme.bodyLarge?.copyWith(fontSize: 16),
),
),
],
),
);
}

@OverRide
void onAudioDeviceChanged(
{HMSAudioDevice? currentAudioDevice,
List? availableAudioDevice}) {}

@OverRide
void onSessionStoreAvailable({HMSSessionStore? hmsSessionStore}) {}

@OverRide
void onPeerListUpdate(
{required List addedPeers,
required List removedPeers}) {}

@OverRide
void onException(
{required HMSActionResultListenerMethod methodType,
Map<String, dynamic>? arguments,
required HMSException hmsException}) {
print("[100ms] Exception in method $methodType: ${hmsException.message}");
}

@OverRide
void onSuccess(
{required HMSActionResultListenerMethod methodType,
Map<String, dynamic>? arguments}) {
print("[100ms] Success in method $methodType with arguments: $arguments");
// TODO: implement onSuccess
}
}

class VoiceRoomState {
final List peers;
final Set speakingPeerIds;
final Map<String, bool> raisedHandPeers;
final bool isMicOn;

const VoiceRoomState({
required this.peers,
required this.speakingPeerIds,
required this.raisedHandPeers,
required this.isMicOn,
});

VoiceRoomState copyWith({
List? peers,
Set? speakingPeerIds,
Map<String, bool>? raisedHandPeers,
bool? isMicOn,
}) {
return VoiceRoomState(
peers: peers ?? this.peers,
speakingPeerIds: speakingPeerIds ?? this.speakingPeerIds,
raisedHandPeers: raisedHandPeers ?? this.raisedHandPeers,
isMicOn: isMicOn ?? this.isMicOn,
);
}

factory VoiceRoomState.initial() => VoiceRoomState(
peers: [],
speakingPeerIds: {},
raisedHandPeers: {},
isMicOn: true,
);
}

[Amjed201]

I already have the microphone permission in Info.plist and PodFile