sound.play 재생 시 다른 앱 소리(음악) 줄이기(ducking) 옵션 요청

[쌉SSUPP]

어떤 제품을 사용하나요?
제품: POS 플러그인 (웹 워커 + 탭 화면)
SDK 또는 API 버전: @tossplace/pos-plugin-sdk 0.0.28
환경: 개발 / 운영 (iPad 토스 POS)

무엇이 궁금한가요?

매장에서 iPad 토스 POS로 픽업 주문 알림을 받고 있습니다. 새 주문이 오면
웹 워커 플러그인에서 sdk.sound.play({ url, volume: 100 })로 안내 음성을 재생합니다.

같은 iPad에서 매장 음악(애플뮤직·유튜브뮤직)을 블루투스 스피커로 틀고 있는데,
알림 음성이 음악과 섞여서 재생되어 잘 들리지 않습니다.
토스 POS 자체 #알림음 (설정 > 알림음)도 같은 방식으로 섞여서 들립니다.

내비게이션 앱처럼 알림 음성이 나오는 동안 다른 앱 소리를 잠깐 줄였다가(ducking)
끝나면 되돌리는 기능을 요청드립니다.

1. sound.play에 다른 앱 소리를 줄이는 옵션(예: duckOthers: true)이나, 잠깐 멈췄다가
   다시 재생하는 옵션(예: interruptOthers: true)을 추가해 주실 수 있을까요?
   (iOS AVAudioSession의 .duckOthers / notifyOthersOnDeactivation 방식)
2. 토스 POS 자체 알림음에도 같은 설정이 있으면 좋겠습니다.
3. 현재 이 기능을 구현할 수 있는 다른 방법이 있다면 알려주세요.

참고로 시도해 본 것:

• 탭 화면(iframe)에서 navigator.audioSession.type = "transient" / "transient-solo" 설정 후
  new Audio(url).play() → NotSupportedError로 재생되지 않습니다. (audioSession.state는 undefined)
• sound.play의 volume을 100으로 올렸지만 음악과 섞이는 것은 같습니다.

감사합니다.

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

문의 주신 알림음 재생 중 다른 앱의 소리를 조절하는 기능에 대해, 현재 지원 범위를 안내 드립니다.

1. Sound API 지원 범위

현재 Sound API에는 다른 앱의 소리를 자동으로 줄이거나 일시 정지한 뒤 복원하는 옵션이 없습니다.

volume은 플러그인에서 재생하는 알림음 자체의 음량을 조절하는 값이므로, 100으로 설정해도 음악 앱의 소리는 줄어들지 않습니다. Sound API 가이드를 참고 부탁 드립니다.

2. 토스 POS 자체 알림음

현재 토스 POS 알림음 설정에서도 다른 앱의 음량을 자동 조절하는 설정은 제공하지 않습니다. 알림음 자체의 음량·반복 횟수 등을 설정하는 방식입니다.

3. 현재 가능한 대안

플러그인에서 애플뮤직·유튜브뮤직의 재생 상태나 음량을 제어하는 API는 제공하지 않습니다. 탭 화면의 audioSession 설정 역시 Sound API에서 제공하는 옵션이 아닙니다.

매장에서는 음악 재생 기기와 POS를 분리하거나, 음악 음량을 낮추고 알림음을 반복 재생하는 방식을 고려해 주세요. 다만 이는 알림 중에만 음악을 자동으로 줄이는 기능과는 다른 운영상 대안입니다.

요청해 주신 기능 추가 사항은 내부 검토 후 안내 드릴 예정입니다.