PodTui/tasks/audio-playback-fix/05-test-multimedia-controls.md

05. Test multimedia controls across platforms

meta: id: audio-playback-fix-05 feature: audio-playback-fix priority: P1 depends_on: [] tags: [testing, integration, cross-platform]

objective:

• Comprehensive testing of volume/speed controls and multimedia key support
• Verify platform-specific media integration works correctly
• Validate all controls across different audio backends

deliverables:

• Test suite for volume/speed controls in src/utils/audio-player.test.ts
• Integration tests for multimedia key handling in src/hooks/useMultimediaKeys.test.ts
• Platform-specific integration tests in src/utils/media-registry.test.ts
• Test coverage report showing all features tested

steps:

• Step 1: Run existing unit tests for audio player backends
• Step 2: Add volume control tests (setVolume, volume clamp, persistence)
• Step 3: Add speed control tests (setSpeed, speed clamp, persistence)
• Step 4: Create integration test for multimedia key handling
• Step 5: Test volume/speed controls with Player component UI
• Step 6: Test multimedia keys with Player component UI
• Step 7: Test platform-specific media integration on each platform
• Step 8: Test all controls across mpv, ffplay, and afplay backends
• Step 9: Document any platform-specific limitations or workarounds

tests:

• Unit:
  • Test volume control methods in all backends
  • Test speed control methods in all backends
  • Test volume clamp logic (0-1 range)
  • Test speed clamp logic (0.25-3 range)
  • Test multimedia key detection
  • Test event listener cleanup
• Integration:
  • Test volume control via Player component UI
  • Test speed control via Player component UI
  • Test multimedia keys via keyboard
  • Test volume/speed persistence across pause/resume
  • Test volume/speed persistence across track changes
• Cross-platform:
  • Test volume/speed controls on macOS
  • Test volume/speed controls on Linux
  • Test volume/speed controls on Windows
  • Test multimedia keys on each platform
  • Test media registration on each platform

acceptance_criteria:

• All unit tests pass with >90% code coverage
• All integration tests pass
• Volume controls work correctly on all platforms
• Speed controls work correctly on all platforms
• Multimedia keys work on all platforms
• Media controls appear on all supported platforms
• All audio backends (mpv, ffplay, afplay) work correctly
• No regressions in existing audio functionality

validation:

• Run full test suite: bun test
• Check test coverage: bun test --coverage
• Manually test volume controls on each platform
• Manually test speed controls on each platform
• Manually test multimedia keys on each platform
• Verify media controls appear on each platform
• Check for any console errors or warnings

notes:

• Test suite should cover all audio backend implementations
• Integration tests should verify UI controls work correctly
• Platform-specific tests should run on actual platform if possible
• Consider using test doubles for platform-specific APIs
• Document any platform-specific issues or limitations found
• Reference: Test patterns from existing test files in src/utils/