# 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/