재생 중 인터럽트 옵션

재생 중 인터럽트 옵션 — 소스라이브 플레이어 iOS SDK

⏱ 예상 소요 시간: 5분 (읽기만)

다루는 상황

시청 중에 플레이어 밖에서 끼어드는 일이 생기면 재생이 멈춥니다.
그 일이 끝난 뒤 다시 재생할지, 멈춘 채 둘지를 정하는 것이 인터럽트 옵션입니다.

상황	재생이 멈추는 이유	끝난 뒤 시청자가 겪는 일
이어폰·헤드셋이 빠짐	소리가 갑자기 스피커로 나가는 것을 막기 위해 멈춥니다	다시 꽂아도 멈춘 상태입니다. 직접 재생을 눌러야 합니다
전화 수신·통화	통화 음성과 겹치지 않도록 멈춥니다	통화가 끝나도 멈춘 상태입니다

💡 라이브 방송에서는 체감이 큽니다 — 다시 재생을 누르는 사이에도 방송은 진행되므로, 시청자는 그 구간을 놓칩니다. 이탈로 이어지기 쉬운 지점입니다.

지정할 수 있게 되는 동작

아래 두 가지를 앱이 정할 수 있도록 준비하고 있습니다.
기본값은 「멈춘 채 둔다」 이므로, 이어서 재생하려면 앱이 켜 주어야 합니다.

지정 항목	기본	켜면
이어폰 재연결 뒤 이어 재생	멈춤 유지	다시 연결하면 자동으로 이어 재생합니다
통화 종료 뒤 이어 재생	멈춤 유지	통화가 끝나면 자동으로 이어 재생합니다

💡 이어 재생할 때 소리를 어떻게 할지도 함께 정할 수 있습니다. 갑자기 소리가 크게 나는 것을 피하려면 음소거로 이어 재생하는 선택이 있습니다. 시청자가 직접 소리를 켜게 됩니다.

💡 어느 쪽이 좋은가 — 라이브 방송은 이어 재생을 켜는 편이 일반적입니다. 다만 이어폰을 뽑는 것이 「그만 보겠다」는 뜻인 경우도 있어, 서비스 성격에 맞춰 정하세요.

연동 코드

Swift

// AppDelegate — 초기화 직후에 한 번만
SauceClient.initInstance(activationKey: "발급받은 활성화 키", apiHost: .stage)

// 이어폰을 다시 꽂으면 이어 재생 (음소거로 시작)
SauceClient.setResumeOnHeadphoneReconnected(true, muted: true)

// 통화가 끝나면 이어 재생
SauceClient.setResumeOnCallEnded(true)

파라미터	타입	기본	설명
첫 번째 인자	`Bool`	`false`	`true` 면 방해가 끝난 뒤 자동으로 이어 재생합니다
`muted`	`Bool`	`false`	`true` 면 음소거 상태로 이어 재생합니다

💡 iOS 는 별도 권한이 필요하지 않습니다. 통화·이어폰 상태는 시스템이 오디오 세션 알림으로 전달하므로 사용자 동의를 받지 않습니다. Android 는 통화 감지에 권한이 필요할 수 있어 이 점이 다릅니다.

💡 먼저 적용해야 한다면 — 담당자에게 문의하면 현재 사용 가능한 방법을 안내받을 수 있습니다.

다음 단계

🔇 음소거 상태 유지

→