본문으로 건너뛰기

미디어 저장소 포맷

formatStorage로 연결된 기기에 저장된 모든 사진, 동영상 및 녹음을 삭제합니다. 이 API는 별도의 파일 시스템 포맷 명령이 아니라 기존의 모든 미디어 삭제 작업을 호출합니다.

:::danger 파괴적 작업

기기의 모든 미디어가 삭제되며 SDK는 복구 기능을 제공하지 않습니다. 시작 전에 사용자의 명시적 확인을 받으세요.

:::

전제 조건

  • 기기가 연결되어 준비 상태가 될 때까지 기다립니다.
  • 녹화를 중지하고 진행 중인 미디어 가져오기를 완료하거나 취소합니다.
  • 작업 중에는 중복 요청을 비활성화합니다.

AI를 활용해 구현

AI로 구현

AI로 이 워크플로 구현

공식 “AIBuds 저장소 포맷” 스킬을 사용해 앱에 맞게 구현하세요.

https://docs-aibuds.github.io/ko/skills/implement-aibuds-format-storage을 읽고 지침을 따르세요. 이 스킬로 “AIBuds 저장소 포맷”을 이 iOS 프로젝트에 구현하고 검증하세요.
공식 스킬 보기

API 동작

완료 콜백은 모든 미디어 삭제 요청이 수락되었는지 알립니다. 갱신된 미디어 개수나 저장소 정보는 반환하지 않습니다.

사용 예제

Swift
import AIBuds

func formatMediaStorage(on device: DeviceConvertible) {
    guard let device = device as? DeviceCommonAPI else {
        print("This device does not support common operations")
        return
    }

    device.formatStorage { success, error in
        DispatchQueue.main.async {
            if success {
                print("All device media was deleted")
            } else {
                print("Delete failed: \(error?.localizedDescription ?? "Unknown error")")
            }
        }
    }
}

결과 처리

  • 성공 후 미디어 개수 조회저장소 정보 조회로 화면을 갱신합니다.
  • 실패하면 진단을 위해 오류를 보존하고 현재 요청이 끝난 뒤에만 재시도를 허용합니다.
  • 완료 전에 연결이 끊기면 기기 상태를 다시 조회할 때까지 결과를 미확정으로 처리합니다.