작업 모드 개요

이 문서에서는 일반 모드와 게임 모드 등 기기의 작업 모드를 관리하는 API를 설명합니다.

기능 개요

📄️작업 모드 조회

AIBuds 기기의 현재 작업 모드 조회

시작하기

작업 모드를 사용하려면 다음 순서로 진행하세요.

기기 연결 - AIBuds 기기와 연결합니다.
프로토콜 확인 - 기기가 DeviceWorkModeAPI 프로토콜을 준수하는지 확인합니다.
현재 모드 확인 - workMode 속성을 읽습니다.
모드 설정 - setWorkMode(_:completion:)을 WorkMode 값과 함께 호출합니다.

핵심 개념

작업 모드

WorkMode에는 다음 값이 정의되어 있습니다.

선택 가능한 모드

WorkMode는 제공되는 열거형 값과 모드 선택에서의 용도를 나타냅니다.

.unknown

현재 모드가 사용 불가능하거나 식별할 수 없습니다. 이 값은 선택할 수 없습니다.

AIBudsWorkModeUnknown

-1

.normal

기기의 일반 작업 모드; SDK는 특정 제품의 오디오 행동을 정의하지 않습니다.

AIBudsWorkModeNormal

.game

기기의 게임 모드; SDK는 특정 제품의 지연 및 오디오 처리 전략을 정의하지 않습니다.

AIBudsWorkModeGame

WorkMode.allCases는 normal과 game만 포함합니다. unknown을 setWorkMode에 전달하지 마세요.

프로토콜 참고

작업 모드 기능은 DeviceWorkModeAPI 프로토콜을 통해 사용합니다.

Swift
Objective-C

guard let device = device as? DeviceWorkModeAPI else {
    print("Device does not support DeviceWorkModeAPI")
    return
}

id<AIBudsDeviceWorkModeAPI> device = (id<AIBudsDeviceWorkModeAPI>)self.device;
if (![device conformsToProtocol:@protocol(AIBudsDeviceWorkModeAPI)]) {
    NSLog(@"Device does not support AIBudsDeviceWorkModeAPI");
    return;
}

권장 사항

프로토콜 확인: 기기가 DeviceWorkModeAPI 프로토콜을 지원하는지 항상 확인하세요.
모드 변경 처리: 기기 delegate에서 변경 알림을 받아야 한다면 device(_:didWorkModeChanged:)을 구현하세요.
결과 안내: 모드가 성공적으로 변경되면 사용자에게 알려 주세요.
사용자 의도 존중: 앱 흐름이나 사용자의 명시적인 동작에 따라 필요한 경우에만 작업 모드를 변경하세요.

참고

모든 기기가 여러 작업 모드를 지원하는 것은 아닙니다.
사용할 수 있는 모드는 기기 기능에 따라 다릅니다.
공개 API는 각 모드가 기기별 음질이나 지연 시간에 미치는 영향을 정의하지 않습니다.

기능 개요​

📄️작업 모드 조회

시작하기​

핵심 개념​

작업 모드​

프로토콜 참고​

권장 사항​

참고​