본문으로 건너뛰기

기기 버튼 조작 개요

이 문서에서는 기기의 물리적 조작과 실행 기능 사이의 매핑을 조회하고 변경하는 방법을 설명합니다.

기능 개요​

AI를 활용해 구현

AI로 구현

AI로 이 워크플로 구현

공식 “AIBuds 물리 조작 관리” 스킬을 사용해 앱에 맞게 구현하세요.

https://docs-aibuds.github.io/ko/skills/manage-aibuds-physical-operations을 읽고 지침을 따르세요. 이 스킬로 “AIBuds 물리 조작 관리”을 이 iOS 프로젝트에 구현하고 검증하세요.
공식 스킬 보기

시작하기​

기기 버튼 조작을 설정하려면 다음 순서로 진행하세요.

  1. 기기 연결 - AIBuds 기기와 연결합니다.
  2. 프로토콜 확인 - 기기가 DevicePhysicalOperationsAPI를 준수하는지 확인합니다.
  3. 조작 매핑 조회 - physicalOperationsMapping을 읽습니다.
  4. 기능 할당 - DeviceFunction을 DeviceOperation에 할당합니다.

핵심 개념​

버튼 매핑​

  • 기기 조작: DeviceOperation은 클릭, 길게 누르기, 터치 패널 제스처, 버튼 및 지원되는 슬라이드 제스처를 나타냅니다.
  • 기기 기능: DeviceFunction은 재생, 음량, 음성 비서, 녹음 및 카메라 동작처럼 할당할 수 있는 기능을 정의합니다.
  • 매핑: physicalOperationsMapping은 조작과 기능의 raw value를 NSNumber 키와 값으로 저장합니다.

프로토콜 참고​

기기 버튼 조작은 DevicePhysicalOperationsAPI를 통해 사용합니다. 매핑을 읽거나 변경하기 전에 프로토콜 준수 여부를 확인하세요.

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

권장 사항​

  1. 프로토콜 확인: 기기가 필요한 프로토콜을 지원하는지 항상 확인하세요.
  2. 보고된 조작만 사용: physicalOperationsMapping에 포함된 조작만 표시하세요.
  3. 오류 처리: completion handler에서 오류를 적절히 처리하세요.
  4. 결과 안내: 버튼 매핑이 성공적으로 변경되면 사용자에게 알려 주세요.

참고​

  • 버튼 매핑 지원 여부는 기기 모델에 따라 다릅니다.
  • DeviceOperation 또는 DeviceFunction에 enum case가 있어도 모든 기기에서 지원된다는 의미는 아닙니다.
  • enum 값이 존재하더라도 조작이나 기능이 지원되지 않을 수 있으므로 할당 결과를 처리하세요.
  • SDK는 KeyMapping 모델이나 비동기 조회 메서드 대신 dictionary로 매핑을 제공합니다.