Voice message: variable play back speed (#5121)

* Implement voice message variable playback speed

* Move playback speed string to Untranslated

https://github.com/element-hq/element-x-ios/pull/5121#discussion_r2822631371

* Address review feedback for voice message playback speed

- Persist voice message playback speed as an enum in AppSettings instead of storing an index.
- Update playback speed cycling to derive from enum allCases and safely fall back to `.default` if the stored value cannot be resolved.
- Apply runtime speed updates in AudioPlayer only when the player is in the `.playing` state.
- Keep MediaPlayerProviderTests formatting/indentation style intact while retaining mock playback speed setup.
- Regenerate preview snapshots for:
  - PlaybackSpeedButton
  - VoiceMessageRoomPlaybackView
  - VoiceMessageRoomTimelineView

* Move VoiceMessagePlaybackSpeed outside AppSettings, remove speedRatio

* Stabilize PlaybackSpeedButton width

* Sync voice-message speed label

- Add voiceMessagePlaybackSpeed to TimelineViewState and bind it from appSettings.$voiceMessagePlaybackSpeed.
- Pass that timeline-level speed into VoiceMessageRoomPlaybackView and use it for PlaybackSpeedButton, so labels update consistently across items.
- Use @EnvironmentObject in VoiceMessageRoomTimelineContent so the view re-renders when timeline context state changes.
- In WaveformInteractionModifier, add .allowsHitTesting(showCursor) to the cursor interaction view so hidden pre-playback cursor hit area does not steal taps from the speed button.

AccessibilityTests/Sources/GeneratedAccessibilityTests.swift

@@ -411,6 +411,10 @@ extension AccessibilityTests {
         try await performAccessibilityAudit(named: "PlaceholderScreen_Previews")
     }
 
+    func testPlaybackSpeedButton() async throws {
+        try await performAccessibilityAudit(named: "PlaybackSpeedButton_Previews")
+    }
+
     func testPollFormScreen() async throws {
         try await performAccessibilityAudit(named: "PollFormScreen_Previews")
     }

ElementX.xcodeproj/project.pbxproj

@@ -124,6 +124,7 @@
 		12EC6BC99F373FE5C6EB9B64 /* TimelineMediaPreviewDetailsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 467498BEA681758BE2F80826 /* TimelineMediaPreviewDetailsView.swift */; };
 		1307268DC41730E5BCF7D9A0 /* PollView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 638790D3F915F0909315C47A /* PollView.swift */; };
 		1318721F4E5F307586D98112 /* VoiceMessageButton.swift in Sources */ = {isa = PBXBuildFile; fileRef = B8516302ACCA94A0E680AB3B /* VoiceMessageButton.swift */; };
+		ES17LAX66UIQ5OAE6L2BQQE4 /* PlaybackSpeedButton.swift in Sources */ = {isa = PBXBuildFile; fileRef = HW13ISECOFUYATOTX2RU7GDG /* PlaybackSpeedButton.swift */; };
 		13C77FDF17C4C6627CFFC205 /* RoomTimelineItemFactoryProtocol.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7D25A35764C7B3DB78954AB5 /* RoomTimelineItemFactoryProtocol.swift */; };
 		13CBC470FB619A6393A21908 /* RoomNotificationSettingsScreenCoordinator.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8296D6FB451E25CEC0767BBA /* RoomNotificationSettingsScreenCoordinator.swift */; };
 		1443CEEE42491CF7CD8A146A /* XCTestCase.swift in Sources */ = {isa = PBXBuildFile; fileRef = 85A1941B874A3BE9CDDF43EF /* XCTestCase.swift */; };
@@ -2557,6 +2558,7 @@
 		B8108C8F0ACF6A7EB72D0117 /* RoomScreenCoordinator.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RoomScreenCoordinator.swift; sourceTree = "<group>"; };
 		B81B6170DB690013CEB646F4 /* MapLibreModels.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MapLibreModels.swift; sourceTree = "<group>"; };
 		B8516302ACCA94A0E680AB3B /* VoiceMessageButton.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = VoiceMessageButton.swift; sourceTree = "<group>"; };
+		HW13ISECOFUYATOTX2RU7GDG /* PlaybackSpeedButton.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PlaybackSpeedButton.swift; sourceTree = "<group>"; };
 		B858A61F2A570DFB8DE570A7 /* AggregratedReaction.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AggregratedReaction.swift; sourceTree = "<group>"; };
 		B88CE0A058727BC68EEEC6B6 /* ShareExtension.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = ShareExtension.entitlements; sourceTree = "<group>"; };
 		B8A3B7637DDBD6AA97AC2545 /* CameraPicker.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CameraPicker.swift; sourceTree = "<group>"; };
@@ -5599,6 +5601,7 @@
 			isa = PBXGroup;
 			children = (
 				AD0FF64B0E6470F66F42E182 /* EstimatedWaveformView.swift */,
+				HW13ISECOFUYATOTX2RU7GDG /* PlaybackSpeedButton.swift */,
 				B8516302ACCA94A0E680AB3B /* VoiceMessageButton.swift */,
 				FB9EABCA9348DFA27439A809 /* WaveformCursorView.swift */,
 				BFEE91FB8ABB5F5884B6D940 /* WaveformInteractionModifier.swift */,
@@ -8800,6 +8803,7 @@
 				2CA61BB208CD82EBDB58CD13 /* VideoRoomTimelineView.swift in Sources */,
 				6FC10A00D268FCD48B631E37 /* ViewFrameReader.swift in Sources */,
 				EED33AFD9334EFD7398707A6 /* VisualListItem.swift in Sources */,
+				ES17LAX66UIQ5OAE6L2BQQE4 /* PlaybackSpeedButton.swift in Sources */,
 				1318721F4E5F307586D98112 /* VoiceMessageButton.swift in Sources */,
 				4681820102DAC8BA586357D4 /* VoiceMessageCache.swift in Sources */,
 				4F2DF6138E87A4B8C2488CA3 /* VoiceMessageCacheProtocol.swift in Sources */,

ElementX/Resources/Localizations/en.lproj/Untranslated.strings

@@ -4,6 +4,9 @@
 /* Used for testing */
 "untranslated" = "Untranslated";
 
+// MARK: - Voice message playback speed
+"a11y_playback_speed" = "Playback speed %1$@";
+
 // MARK: - Soft logout
 
 "soft_logout_signin_title" = "Sign in";

ElementX/Sources/Application/Settings/AppSettings.swift

@@ -82,6 +82,8 @@ final class AppSettings {
         case spaceSettingsEnabled
         case createSpaceEnabled
         
+        case voiceMessagePlaybackSpeed
+
         // Doug's tweaks 🔧
         case hideUnreadMessagesBadge
         case hideQuietNotificationAlerts
@@ -359,7 +361,10 @@ final class AppSettings {
     
     @UserPreference(key: UserDefaultsKeys.optimizeMediaUploads, defaultValue: true, storageType: .userDefaults(store))
     var optimizeMediaUploads
-    
+
+    @UserPreference(key: UserDefaultsKeys.voiceMessagePlaybackSpeed, defaultValue: VoiceMessagePlaybackSpeed.default, storageType: .userDefaults(store))
+    var voiceMessagePlaybackSpeed: VoiceMessagePlaybackSpeed
+
     /// Whether or not to show a warning on the media caption composer so the user knows
     /// that captions might not be visible to users who are using other Matrix clients.
     let shouldShowMediaCaptionWarning = true
@@ -447,3 +452,10 @@ final class AppSettings {
 }
 
 extension AppSettings: CommonSettingsProtocol { }
+
+enum VoiceMessagePlaybackSpeed: Float, CaseIterable, Codable {
+    case `default` = 1.0
+    case fast = 1.5
+    case fastest = 2.0
+    case slow = 0.5
+}

ElementX/Sources/Generated/Strings+Untranslated.swift

@@ -10,6 +10,10 @@ import Foundation
 // swiftlint:disable explicit_type_interface function_parameter_count identifier_name line_length
 // swiftlint:disable nesting type_body_length type_name vertical_whitespace_opening_braces
 internal enum UntranslatedL10n {
+  /// Playback speed %1$@
+  internal static func a11yPlaybackSpeed(_ p1: Any) -> String {
+    return UntranslatedL10n.tr("Untranslated", "a11y_playback_speed", String(describing: p1))
+  }
   /// Clear all data currently stored on this device?
   /// Sign in again to access your account data and messages.
   internal static var softLogoutClearDataDialogContent: String { return UntranslatedL10n.tr("Untranslated", "soft_logout_clear_data_dialog_content") }

ElementX/Sources/Mocks/Generated/GeneratedMocks.swift

@@ -1222,6 +1222,11 @@ class AudioPlayerMock: AudioPlayerProtocol, @unchecked Sendable {
         set(value) { underlyingState = value }
     }
     var underlyingState: MediaPlayerState!
+    var playbackSpeed: Float {
+        get { return underlyingPlaybackSpeed }
+        set(value) { underlyingPlaybackSpeed = value }
+    }
+    var underlyingPlaybackSpeed: Float!
     var actions: AnyPublisher<AudioPlayerAction, Never> {
         get { return underlyingActions }
         set(value) { underlyingActions = value }
@@ -1450,6 +1455,47 @@ class AudioPlayerMock: AudioPlayerProtocol, @unchecked Sendable {
         }
         await seekToClosure?(progress)
     }
+    //MARK: - setPlaybackSpeed
+
+    var setPlaybackSpeedUnderlyingCallsCount = 0
+    var setPlaybackSpeedCallsCount: Int {
+        get {
+            if Thread.isMainThread {
+                return setPlaybackSpeedUnderlyingCallsCount
+            } else {
+                var returnValue: Int? = nil
+                DispatchQueue.main.sync {
+                    returnValue = setPlaybackSpeedUnderlyingCallsCount
+                }
+
+                return returnValue!
+            }
+        }
+        set {
+            if Thread.isMainThread {
+                setPlaybackSpeedUnderlyingCallsCount = newValue
+            } else {
+                DispatchQueue.main.sync {
+                    setPlaybackSpeedUnderlyingCallsCount = newValue
+                }
+            }
+        }
+    }
+    var setPlaybackSpeedCalled: Bool {
+        return setPlaybackSpeedCallsCount > 0
+    }
+    var setPlaybackSpeedReceivedSpeed: Float?
+    var setPlaybackSpeedReceivedInvocations: [Float] = []
+    var setPlaybackSpeedClosure: ((Float) -> Void)?
+
+    func setPlaybackSpeed(_ speed: Float) {
+        setPlaybackSpeedCallsCount += 1
+        setPlaybackSpeedReceivedSpeed = speed
+        DispatchQueue.main.async {
+            self.setPlaybackSpeedReceivedInvocations.append(speed)
+        }
+        setPlaybackSpeedClosure?(speed)
+    }
 }
 class AudioRecorderMock: AudioRecorderProtocol, @unchecked Sendable {
     var actions: AnyPublisher<AudioRecorderAction, Never> {

ElementX/Sources/Other/TestablePreview/TestablePreviewsDictionary.swift

@@ -110,6 +110,7 @@ enum TestablePreviewsDictionary {
         "PinnedItemsIndicatorView_Previews" : PinnedItemsIndicatorView_Previews.self,
         "PlaceholderAvatarImage_Previews" : PlaceholderAvatarImage_Previews.self,
         "PlaceholderScreen_Previews" : PlaceholderScreen_Previews.self,
+        "PlaybackSpeedButton_Previews" : PlaybackSpeedButton_Previews.self,
         "PollFormScreen_Previews" : PollFormScreen_Previews.self,
         "PollOptionView_Previews" : PollOptionView_Previews.self,
         "PollRoomTimelineView_Previews" : PollRoomTimelineView_Previews.self,

ElementX/Sources/Other/VoiceMessage/PlaybackSpeedButton.swift

@@ -0,0 +1,53 @@
+//
+// Copyright 2025 Element Creations Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import SwiftUI
+
+struct PlaybackSpeedButton: View {
+    let speed: Float
+    let onTap: () -> Void
+
+    var body: some View {
+        Button(action: onTap) {
+            ZStack {
+                Text("0.0x")
+                    .font(.compound.bodyXSSemibold)
+                    .hidden()
+
+                Text(speedLabel)
+                    .font(.compound.bodyXSSemibold)
+                    .foregroundColor(.compound.iconSecondary)
+            }
+            .padding(.horizontal, 8)
+            .padding(.vertical, 2)
+            .background(.compound.bgCanvasDefault, in: RoundedRectangle(cornerRadius: 12))
+        }
+        .buttonStyle(.plain)
+        .accessibilityLabel(UntranslatedL10n.a11yPlaybackSpeed(speedLabel))
+    }
+
+    private var speedLabel: String {
+        if speed == Float(Int(speed)) {
+            "\(Int(speed))x"
+        } else {
+            String(format: "%gx", speed)
+        }
+    }
+}
+
+struct PlaybackSpeedButton_Previews: PreviewProvider, TestablePreview {
+    static var previews: some View {
+        HStack(spacing: 8) {
+            PlaybackSpeedButton(speed: 0.5) { }
+            PlaybackSpeedButton(speed: 1.0) { }
+            PlaybackSpeedButton(speed: 1.5) { }
+            PlaybackSpeedButton(speed: 2.0) { }
+        }
+        .padding()
+        .background(Color.gray)
+    }
+}

ElementX/Sources/Other/VoiceMessage/WaveformInteractionModifier.swift

@@ -41,6 +41,7 @@ private struct WaveformInteractionModifier: ViewModifier {
                                 onSeek(max(0, min(progress, 1.0)))
                             })
                         .offset(x: -cursorInteractiveSize / 2, y: 0)
+                        .allowsHitTesting(showCursor)
                 }
                 .gesture(SpatialTapGesture()
                     .onEnded { tapGesture in

ElementX/Sources/Screens/Timeline/TimelineInteractionHandler.swift

@@ -417,7 +417,21 @@ class TimelineInteractionHandler {
     }
     
     // MARK: Audio Playback
-    
+
+    func changePlaybackSpeed(for itemID: TimelineItemIdentifier) {
+        let availableSpeeds = VoiceMessagePlaybackSpeed.allCases
+        guard let currentIndex = availableSpeeds.firstIndex(of: appSettings.voiceMessagePlaybackSpeed) else {
+            appSettings.voiceMessagePlaybackSpeed = .default
+            audioPlayerState(for: itemID)?.setPlaybackSpeed(VoiceMessagePlaybackSpeed.default.rawValue)
+            return
+        }
+
+        let nextIndex = (currentIndex + 1) % availableSpeeds.count
+        let nextSpeed = availableSpeeds[nextIndex]
+        appSettings.voiceMessagePlaybackSpeed = nextSpeed
+        audioPlayerState(for: itemID)?.setPlaybackSpeed(nextSpeed.rawValue)
+    }
+
     func playPauseAudio(for itemID: TimelineItemIdentifier) async {
         MXLog.info("Toggle play/pause audio for itemID \(itemID)")
         guard let timelineItem = timelineController.timelineItems.firstUsingStableID(itemID) else {
@@ -447,6 +461,7 @@ class TimelineInteractionHandler {
         // Ensure this one is attached
         if !audioPlayerState.isAttached {
             audioPlayerState.attachAudioPlayer(audioPlayer)
+            audioPlayerState.setPlaybackSpeed(appSettings.voiceMessagePlaybackSpeed.rawValue)
         }
 
         // Detach all other states

ElementX/Sources/Screens/Timeline/TimelineModels.swift

@@ -42,6 +42,7 @@ enum TimelineViewPollAction {
 enum TimelineAudioPlayerAction {
     case playPause(itemID: TimelineItemIdentifier)
     case seek(itemID: TimelineItemIdentifier, progress: Double)
+    case changePlaybackSpeed(itemID: TimelineItemIdentifier)
 }
 
 enum TimelineViewAction {
@@ -114,6 +115,7 @@ struct TimelineViewState: BindableState {
     var isViewSourceEnabled: Bool
     var areThreadsEnabled: Bool
     var linkPreviewsEnabled: Bool
+    var voiceMessagePlaybackSpeed = VoiceMessagePlaybackSpeed.default.rawValue
     
     let hasPredecessor: Bool
         

ElementX/Sources/Screens/Timeline/TimelineViewModel.swift

@@ -102,6 +102,7 @@ class TimelineViewModel: TimelineViewModelType, TimelineViewModelProtocol {
                                                        isViewSourceEnabled: appSettings.viewSourceEnabled,
                                                        areThreadsEnabled: appSettings.threadsEnabled,
                                                        linkPreviewsEnabled: appSettings.linkPreviewsEnabled,
+                                                       voiceMessagePlaybackSpeed: appSettings.voiceMessagePlaybackSpeed.rawValue,
                                                        hasPredecessor: roomProxy.predecessorRoom != nil,
                                                        pinnedEventIDs: roomProxy.infoPublisher.value.pinnedEventIDs,
                                                        emojiProvider: emojiProvider,
@@ -370,6 +371,8 @@ class TimelineViewModel: TimelineViewModelType, TimelineViewModelProtocol {
             Task { await timelineInteractionHandler.playPauseAudio(for: itemID) }
         case .seek(let itemID, let progress):
             Task { await timelineInteractionHandler.seekAudio(for: itemID, progress: progress) }
+        case .changePlaybackSpeed(let itemID):
+            timelineInteractionHandler.changePlaybackSpeed(for: itemID)
         }
     }
     
@@ -540,6 +543,11 @@ class TimelineViewModel: TimelineViewModelType, TimelineViewModelProtocol {
         appSettings.$threadsEnabled
             .weakAssign(to: \.state.areThreadsEnabled, on: self)
             .store(in: &cancellables)
+
+        appSettings.$voiceMessagePlaybackSpeed
+            .map(\.rawValue)
+            .weakAssign(to: \.state.voiceMessagePlaybackSpeed, on: self)
+            .store(in: &cancellables)
         
         userSession.clientProxy.timelineMediaVisibilityPublisher
             .removeDuplicates()

ElementX/Sources/Screens/Timeline/View/TimelineItemViews/VoiceMessageRoomTimelineView.swift

@@ -23,7 +23,7 @@ struct VoiceMessageRoomTimelineView: View {
 }
 
 struct VoiceMessageRoomTimelineContent: View {
-    @Environment(\.timelineContext) private var context
+    @EnvironmentObject private var context: TimelineViewModel.Context
     @State private var resumePlaybackAfterScrubbing = false
     
     let timelineItem: VoiceMessageRoomTimelineItem
@@ -33,27 +33,33 @@ struct VoiceMessageRoomTimelineContent: View {
         VoiceMessageRoomPlaybackView(playerState: playerState,
                                      onPlayPause: onPlaybackPlayPause,
                                      onSeek: { onPlaybackSeek($0) },
-                                     onScrubbing: { onPlaybackScrubbing($0) })
+                                     onScrubbing: { onPlaybackScrubbing($0) },
+                                     playbackSpeed: context.viewState.voiceMessagePlaybackSpeed,
+                                     onPlaybackSpeedChange: onPlaybackSpeedChange)
             .fixedSize(horizontal: false, vertical: true)
     }
-    
+
     private func onPlaybackPlayPause() {
-        context?.send(viewAction: .handleAudioPlayerAction(.playPause(itemID: timelineItem.id)))
+        context.send(viewAction: .handleAudioPlayerAction(.playPause(itemID: timelineItem.id)))
+    }
+
+    private func onPlaybackSpeedChange() {
+        context.send(viewAction: .handleAudioPlayerAction(.changePlaybackSpeed(itemID: timelineItem.id)))
     }
     
     private func onPlaybackSeek(_ progress: Double) {
-        context?.send(viewAction: .handleAudioPlayerAction(.seek(itemID: timelineItem.id, progress: progress)))
+        context.send(viewAction: .handleAudioPlayerAction(.seek(itemID: timelineItem.id, progress: progress)))
     }
     
     private func onPlaybackScrubbing(_ dragging: Bool) {
         if dragging {
             if playerState.playbackState == .playing {
                 resumePlaybackAfterScrubbing = true
-                context?.send(viewAction: .handleAudioPlayerAction(.playPause(itemID: timelineItem.id)))
+                context.send(viewAction: .handleAudioPlayerAction(.playPause(itemID: timelineItem.id)))
             }
         } else {
             if resumePlaybackAfterScrubbing {
-                context?.send(viewAction: .handleAudioPlayerAction(.playPause(itemID: timelineItem.id)))
+                context.send(viewAction: .handleAudioPlayerAction(.playPause(itemID: timelineItem.id)))
                 resumePlaybackAfterScrubbing = false
             }
         }

ElementX/Sources/Screens/Timeline/View/VoiceMessageRoomPlaybackView.swift

@@ -19,18 +19,23 @@ struct VoiceMessageRoomPlaybackView: View {
     let onPlayPause: () -> Void
     let onSeek: (Double) -> Void
     let onScrubbing: (Bool) -> Void
-    
+    let playbackSpeed: Float
+    let onPlaybackSpeedChange: () -> Void
+
     var body: some View {
         HStack(spacing: 8) {
             VoiceMessageButton(state: .init(playerState.playerButtonPlaybackState),
                                size: .medium,
                                action: onPlayPause)
-            Text(timeLabelContent)
+            VStack(spacing: 2) {
-                .lineLimit(1)
+                PlaybackSpeedButton(speed: playbackSpeed, onTap: onPlaybackSpeedChange)
-                .font(.compound.bodySMSemibold)
+                Text(timeLabelContent)
-                .foregroundColor(.compound.textSecondary)
+                    .lineLimit(1)
-                .monospacedDigit()
+                    .font(.compound.bodyXSSemibold)
-                .fixedSize(horizontal: true, vertical: true)
+                    .foregroundColor(.compound.textSecondary)
+                    .monospacedDigit()
+                    .fixedSize(horizontal: true, vertical: true)
+            }
 
             waveformView
                 .waveformInteraction(isDragging: $isDragging,
@@ -129,7 +134,9 @@ struct VoiceMessageRoomPlaybackView_Previews: PreviewProvider, TestablePreview {
         VoiceMessageRoomPlaybackView(playerState: playerState,
                                      onPlayPause: { },
                                      onSeek: { value in Task { await playerState.updateState(progress: value) } },
-                                     onScrubbing: { _ in })
+                                     onScrubbing: { _ in },
+                                     playbackSpeed: playerState.playbackSpeed,
+                                     onPlaybackSpeedChange: { })
             .fixedSize(horizontal: false, vertical: true)
     }
 }

ElementX/Sources/Services/Audio/Player/AudioPlayer.swift

@@ -48,7 +48,8 @@ class AudioPlayer: NSObject, AudioPlayerProtocol {
     private let releaseAudioSessionTimeoutInterval = 5.0
     
     private(set) var playbackURL: URL?
-    
+    private(set) var playbackSpeed: Float = 1.0
+
     private var deinitInProgress = false
     
     var duration: TimeInterval {
@@ -106,7 +107,7 @@ class AudioPlayer: NSObject, AudioPlayerProtocol {
     func play() {
         isStopped = false
         setupAudioSession()
-        internalAudioPlayer?.play()
+        internalAudioPlayer?.rate = playbackSpeed
     }
     
     func pause() {
@@ -128,7 +129,14 @@ class AudioPlayer: NSObject, AudioPlayerProtocol {
         let time = progress * duration
         await internalAudioPlayer.seek(to: CMTime(seconds: time, preferredTimescale: 60))
     }
-    
+
+    func setPlaybackSpeed(_ speed: Float) {
+        playbackSpeed = speed
+        if state == .playing {
+            internalAudioPlayer?.rate = speed
+        }
+    }
+
     // MARK: - Private
     
     private func setupAudioSession() {

ElementX/Sources/Services/Audio/Player/AudioPlayerProtocol.swift

@@ -40,15 +40,17 @@ protocol AudioPlayerProtocol: AnyObject {
     var currentTime: TimeInterval { get }
     var playbackURL: URL? { get }
     var state: MediaPlayerState { get }
-    
+    var playbackSpeed: Float { get }
+
     var actions: AnyPublisher<AudioPlayerAction, Never> { get }
-    
+
     func load(sourceURL: URL, playbackURL: URL, autoplay: Bool)
     func reset()
     func play()
     func pause()
     func stop()
     func seek(to progress: Double) async
+    func setPlaybackSpeed(_ speed: Float)
 }
 
 // sourcery: AutoMockable

ElementX/Sources/Services/Audio/Player/AudioPlayerState.swift

@@ -36,6 +36,7 @@ class AudioPlayerState: ObservableObject, Identifiable {
     /// It's similar to `playbackState`, with the a difference: `.loading`
     /// updates are delayed by a fixed amount of time
     @Published private(set) var playerButtonPlaybackState: AudioPlayerPlaybackState
+    @Published private(set) var playbackSpeed: Float = 1.0
 
     private weak var audioPlayer: AudioPlayerProtocol?
     private var audioPlayerSubscription: AnyCancellable?
@@ -110,7 +111,12 @@ class AudioPlayerState: ObservableObject, Identifiable {
     func reportError() {
         playbackState = .error
     }
-    
+
+    func setPlaybackSpeed(_ speed: Float) {
+        playbackSpeed = speed
+        audioPlayer?.setPlaybackSpeed(speed)
+    }
+
     // MARK: - Private
     
     private func subscribeToAudioPlayer(audioPlayer: AudioPlayerProtocol) {

PreviewTests/Sources/GeneratedPreviewTests.swift

@@ -718,6 +718,13 @@ extension PreviewTests {
         }
     }
 
+    func testPlaybackSpeedButton() async throws {
+        AppSettings.resetAllSettings() // Ensure this test's previews start with fresh settings.
+        for (index, preview) in PlaybackSpeedButton_Previews._allPreviews.enumerated() {
+            try await assertSnapshots(matching: preview, step: index)
+        }
+    }
+
     func testPollFormScreen() async throws {
         AppSettings.resetAllSettings() // Ensure this test's previews start with fresh settings.
         for (index, preview) in PollFormScreen_Previews._allPreviews.enumerated() {

PreviewTests/Sources/__Snapshots__/PreviewTests/playbackSpeedButton.iPad-en-GB-0.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7473df382774c7badd74735d39bd84d4669172870eb2013b5549f3c31714aef3
+size 71249

PreviewTests/Sources/__Snapshots__/PreviewTests/playbackSpeedButton.iPad-pseudo-0.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7473df382774c7badd74735d39bd84d4669172870eb2013b5549f3c31714aef3
+size 71249

PreviewTests/Sources/__Snapshots__/PreviewTests/playbackSpeedButton.iPhone-en-GB-0.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:567bc2d7980ce4abb548c1851b7a1600b5a4da86a13a90006c0359c378f37ba4
+size 30008

PreviewTests/Sources/__Snapshots__/PreviewTests/playbackSpeedButton.iPhone-pseudo-0.png

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:567bc2d7980ce4abb548c1851b7a1600b5a4da86a13a90006c0359c378f37ba4
+size 30008

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomPlaybackView.iPad-en-GB-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:2bae7bf388a08eea2c5e13c0ef6d0c51858dc9f46dcf5cca5b7dc79f6270410f
+oid sha256:15ce484f5c7dfcbd8c5f226c11962e5a0cc51f67e38f04f61879c7dbd41a1a78
-size 71827
+size 72637

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomPlaybackView.iPad-pseudo-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:2bae7bf388a08eea2c5e13c0ef6d0c51858dc9f46dcf5cca5b7dc79f6270410f
+oid sha256:15ce484f5c7dfcbd8c5f226c11962e5a0cc51f67e38f04f61879c7dbd41a1a78
-size 71827
+size 72637

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomPlaybackView.iPhone-en-GB-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bc034b48c12a30db34d74e7b105886ce33ed9d37b7ebd97bd59f070d2af806b6
+oid sha256:09fef09be6c353e64124f0f8044140ffca8bab8f3ae542445b4b6d0a2dd78b5f
-size 30299
+size 30861

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomPlaybackView.iPhone-pseudo-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bc034b48c12a30db34d74e7b105886ce33ed9d37b7ebd97bd59f070d2af806b6
+oid sha256:09fef09be6c353e64124f0f8044140ffca8bab8f3ae542445b4b6d0a2dd78b5f
-size 30299
+size 30861

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomTimelineView.iPad-en-GB-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:f518c5ce36c085ec697501297d0303044042b8df1341fcf0d02b08b3eef58959
+oid sha256:6b2ceba201b14a637977eb6b0f7b15ac119138402a9e502da002305ddce95bc0
-size 77812
+size 78972

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomTimelineView.iPad-pseudo-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3d456a81d249a01c6817c0bb35bf2a501ca641918009533c3a8dbb9db2739456
+oid sha256:6b2ceba201b14a637977eb6b0f7b15ac119138402a9e502da002305ddce95bc0
-size 78571
+size 78972

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomTimelineView.iPhone-en-GB-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:cef3e1dc07041a0624fe8f900b36c61962dc6d0f956fc532deb3262853448c10
+oid sha256:65d7f7c53532549016386f37ea663fd7cce7f2827db931892622de94c6bff980
-size 36670
+size 37285

PreviewTests/Sources/__Snapshots__/PreviewTests/voiceMessageRoomTimelineView.iPhone-pseudo-0.png

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:abf4ef40082a65fa07969637dfdaf2b218953fa45281a7b0d62dd532889c9e44
+oid sha256:65d7f7c53532549016386f37ea663fd7cce7f2827db931892622de94c6bff980
-size 37417
+size 37285

UnitTests/Sources/AudioPlayerStateTests.swift

@@ -31,6 +31,7 @@ struct AudioPlayerStateTests {
         audioPlayerMock.state = .stopped
         audioPlayerMock.currentTime = 0.0
         audioPlayerMock.duration = 0.0
+        audioPlayerMock.playbackSpeed = 1.0
         audioPlayerMock.seekToClosure = { [audioPlayerSeekCallsSubject] progress in
             audioPlayerSeekCallsSubject?.send(progress)
         }
@@ -274,6 +275,31 @@ struct AudioPlayerStateTests {
         #expect(!audioPlayerState.showProgressIndicator)
     }
     
+    func testSetPlaybackSpeed() {
+        audioPlayerState.attachAudioPlayer(audioPlayerMock)
+
+        XCTAssertEqual(audioPlayerState.playbackSpeed, 1.0)
+
+        audioPlayerState.setPlaybackSpeed(1.5)
+        XCTAssertEqual(audioPlayerState.playbackSpeed, 1.5)
+        XCTAssertEqual(audioPlayerMock.setPlaybackSpeedReceivedSpeed, 1.5)
+
+        audioPlayerState.setPlaybackSpeed(2.0)
+        XCTAssertEqual(audioPlayerState.playbackSpeed, 2.0)
+        XCTAssertEqual(audioPlayerMock.setPlaybackSpeedReceivedSpeed, 2.0)
+
+        audioPlayerState.setPlaybackSpeed(0.5)
+        XCTAssertEqual(audioPlayerState.playbackSpeed, 0.5)
+        XCTAssertEqual(audioPlayerMock.setPlaybackSpeedReceivedSpeed, 0.5)
+    }
+
+    func testSetPlaybackSpeedWithoutPlayer() {
+        XCTAssertEqual(audioPlayerState.playbackSpeed, 1.0)
+
+        audioPlayerState.setPlaybackSpeed(2.0)
+        XCTAssertEqual(audioPlayerState.playbackSpeed, 2.0)
+    }
+
     @Test
     func audioPlayerActionsDidFailed() async throws {
         audioPlayerState.attachAudioPlayer(audioPlayerMock)

UnitTests/Sources/MediaPlayerProviderTests.swift

@@ -42,6 +42,7 @@ struct MediaPlayerProviderTests {
     func detachAllStates() {
         let audioPlayer = AudioPlayerMock()
         audioPlayer.actions = PassthroughSubject<AudioPlayerAction, Never>().eraseToAnyPublisher()
+        audioPlayer.playbackSpeed = 1.0
         
         let audioPlayerStates = Array(repeating: AudioPlayerState(id: .timelineItemIdentifier(.randomEvent), title: "", duration: 0), count: 10)
         for audioPlayerState in audioPlayerStates {
@@ -62,6 +63,7 @@ struct MediaPlayerProviderTests {
     func detachAllStatesWithException() {
         let audioPlayer = AudioPlayerMock()
         audioPlayer.actions = PassthroughSubject<AudioPlayerAction, Never>().eraseToAnyPublisher()
+        audioPlayer.playbackSpeed = 1.0
         
         let audioPlayerStates = Array(repeating: AudioPlayerState(id: .timelineItemIdentifier(.randomEvent), title: "", duration: 0), count: 10)
         for audioPlayerState in audioPlayerStates {

UnitTests/Sources/VoiceMessageRecorderTests.swift

@@ -42,6 +42,7 @@ class VoiceMessageRecorderTests: XCTestCase {
         audioPlayer = AudioPlayerMock()
         audioPlayer.actions = audioPlayerActions
         audioPlayer.state = .stopped
+        audioPlayer.playbackSpeed = 1.0
         
         mediaPlayerProvider = MediaPlayerProviderMock()
         mediaPlayerProvider.player = audioPlayer