커스텀 사운드 팩 — 직접 만들고 가져오는 방법

Vigilant Ear는 새로운 소리를 학습할 수 있습니다. 커스텀 사운드 팩은 Apple 기본 감지기가 모르는 소리 — 동네 새, 직장 특정 기계, 건물 복도의 이상한 부저 등 — 를 앱이 인식하도록 가르칩니다. Mac에서 작은 모델을 학습하고(코딩 불필요), 두 개의 작은 텍스트 파일과 함께 zip으로 묶어 iPhone에 가져오면 됩니다.

커스텀 팩은 기본 감지기 위에 겹쳐 동작합니다. 팩을 켜도 다른 것은 꺼지지 않습니다 — 사이렌, 알람, 그 밖의 모든 안전 소리는 이전과 똑같이 계속 작동합니다.

필요한 것: Xcode의 Create ML 앱이 있는 Mac(무료), 대상 소리의 오디오 녹음, iPhone의 Power Pack+(무료 체험도 해당).

필수 조건 — 정확히 지키세요

아래 중 하나라도 무시하면 팩은 가져오지만 동작이 나빠집니다(끊임없는 오경보, 또는 아무것도 감지되지 않음). 권장 사항이 아닙니다:

1. Background 클래스를 포함하세요 — 선택이 아니라 필수입니다. 모델에는 실제 주변 환경(조용한 방, 거리, 선풍기 소리 등)으로 학습한 클래스가 있어야 합니다. 실제 녹음 15개 이상을 넣고, profiles.json에서 "category": "ignored"와 "threshold": 1.1로 표시하세요. Background 클래스가 없으면 팩이 침묵 속에서도 계속 울립니다 — 사운드 분류기는 매 순간 오디오를 자기 클래스 중 하나로 골라야 하므로, "해당 없음" 버킷이 없으면 조용한 방도 가장 비슷한 소리로 라벨링합니다.
2. 학습 클립에서 침묵을 잘라 내세요. "Owl"이라고 라벨된 클립이 20초 침묵에 울음 한 번이면, 모델은 침묵이 올빼미라고 배웁니다. 대상 소리에 맞게 클립을 타이트하게 자르지 않으면 모델이 빈 구간까지 학습합니다.
3. 모델 파일 이름은 정확히 model.mlmodel 또는 model.mlpackage로 하세요. 다른 이름 → 가져오기 실패.
4. Create ML Sound Classification 모델을 사용하세요. 이미지/텍스트/표 형식 모델은 거부됩니다.
5. profiles.json 키는 모델의 클래스 라벨과 정확히 일치해야 합니다 — 즉 학습 폴더 이름, 대소문자와 밑줄(_ ) 포함.
6. gateClasses를 추가하세요(아래 참고). 없으면 음악과 TV가 팩을 트리거합니다. 오경보를 줄이는 가장 큰 수단입니다.
7. 파일을 최상위에서 zip으로 묶으세요(또는 한 단계 폴더 안 — 더 깊게는 안 됨). pack.json을 찾을 수 있어야 합니다.
8. 클래스 균형을 맞추세요. 한 클래스에 클립 100개, 다른 클래스에 10개를 주지 마세요 — 모델이 많은 쪽으로 치우칩니다. 많이 모은 클래스는 잘라서 개수가 서로 약 3배 이내가 되게 하세요.

이 가이드의 나머지는 위를 순서대로 다룹니다.

1단계 — 학습용 오디오 모으기

인식할 소리마다 그 이름으로 폴더를 만들고, 예제 녹음으로 채우세요:

TrainingData/
  Mourning_Dove/        ← 20+ clips of mourning doves
  House_Finch/          ← 20+ clips of house finches
  Background/           ← 20+ clips of your ambient environment WITHOUT the sounds

실제로 차이를 만드는 팁:

• 항상 Background 클래스를 포함하세요. 모델은 오디오의 매 순간을 무언가로 라벨해야 합니다 — 배경 클래스가 없으면 침묵과 거리 소음이 실제 클래스로 밀려 들어가 오경보가 납니다. 팩을 실제로 쓸 장소를 녹음하세요: 마당, 작업장 바닥, 주방 등.
• 폴더 이름이 라벨이 됩니다(밑줄은 공백으로: Mourning_Dove → "Mourning Dove"). 나중에 profiles.json에서 표시 이름을 덮어쓸 수 있습니다.
• 길이보다 다양성: 거리, 시간대, 배경 조건을 다르게. 수 초짜리 클립도 충분합니다.
• 일반적인 형식은 모두 됩니다(.m4a, .wav, .mp3, .aiff).

2단계 — Create ML에서 모델 학습

1. Create ML을 엽니다(Xcode가 있는 Mac: Xcode 메뉴 → Open Developer Tool → Create ML). 새 Sound Classification 프로젝트를 만듭니다.
2. TrainingData 폴더를 Training Data로 끌어다 놓습니다.
3. Train을 클릭합니다. 클립 수백 개면 수 분 안에 학습됩니다.
4. 정확도 탭을 확인하세요 — 한 클래스 점수가 나쁘면 더 많거나 더 다양한 클립이 필요합니다.
5. Output 탭에서 Get을 클릭하고 모델을 model.mlmodel(또는 model.mlpackage — 둘 다 가능)로 저장합니다. 파일 이름은 정확히 model.mlmodel 또는 model.mlpackage여야 합니다.

3단계 — pack.json 작성

팩을 설명하는 작은 매니페스트:

{
  "id": "com.example.pack.socalbirds",
  "name": "SoCal Birder's Companion",
  "version": "1.0",
  "author": "Your Name",
  "classes": ["Mourning_Dove", "House_Finch", "Background"],
  "gateClasses": ["bird", "bird_vocalization", "bird_chirp_tweet", "pigeon_dove_coo", "crow_caw"]
}

• **name**은 필수 — 앱의 팩 목록에 표시되는 이름입니다.
• **id**는 업데이트용 식별자: 같은 id로 다시 가져오면 이전 버전을 그 자리에서 교체합니다. 고유한 reverse-DNS 스타일 문자열이면 됩니다.
• **classes**는 문서용일 뿐입니다. 앱은 실제 클래스 목록을 모델에서 읽으므로, 불일치해도 동작이 깨지지는 않습니다(로그만 남음).
• gateClasses(선택, 강력 권장)는 오탐을 막는 가장 효과적인 도구입니다. 아래를 보세요.

gateClasses — Apple 모델을 문지기로 쓰기

당신의 모델은 전문가입니다: 어떤 대상 소리인지 구분하는 데는 좋지만, "내 소리가 아님"이 무엇인지는 모릅니다(Background 클래스가 그 역할을 돕습니다). Apple 기본 분류기는 일상 소리 약 300개로 학습된 범용 모델이라, "새가 있는지?" 같은 거친 질문에 매우 강합니다.

gateClasses는 둘을 연결합니다: 팩의 감지는 Apple 모델이 나열된 기본 카테고리 중 하나를 동시에 듣고 있을 때만 보고됩니다. 새 팩은 Apple의 새 라벨로 게이트하므로, Apple이 새라고 보지 않으면 팩이 아무리 확신해도 조용합니다. 이 한 줄이 음악·TV·조용한 방 오경보의 대부분을 없앱니다 — Apple 모델이 그런 소리에 게이트 아래로 점수를 주기 때문입니다. 빼 두면 게이트 없이 동작합니다(테스트에는 괜찮고, 실사용에서는 말이 많아집니다).

게이트는 Apple에 이미 해당 소리에 가까운 카테고리가 있을 때만 가능합니다. Apple의 약 300클래스 모델이 모르는 것 — 특정 공장 기계, 의료기기 비프, 커스텀 초인종 — 이면 게이트할 기본 라벨이 없으므로 gateClasses를 비우고 게이트 없이 돌립니다. 예상된 동작이지 실수가 아닙니다. 그런 팩에서는 Background 클래스가 여러 방어 중 하나가 아니라, 끊임없는 오경보와 당신 사이에 선 유일한 방어가 됩니다 — 실제 주변 녹음에 많이 투자하고, 클래스별 threshold를 올리세요.

새(bird) 팩은 일반적인 Apple 새 라벨과, 모델이 실제로 이름 붙일 수 있는 구체 라벨에 게이트하세요: bird, fowl, bird_vocalization, bird_chirp_tweet, bird_squawk, bird_flapping — 그리고 팩에 해당 종이 있으면 crow_caw, pigeon_dove_coo. 다른 팩 유형은 아래 부록의 기본 사운드 식별자 전체 목록에서 게이트를 고르세요 — 예: 견종 팩은 dog_bark/dog_howl, 차량 팩은 engine/truck.

muteClasses — 모델이 이름 붙일 수 없는 소리는 Apple에 맡기기

gateClasses는 Apple이 새라고 생각할 때 팩을 엽니다. 하지만 Apple은 당신 모델이 다루지 않는 새를 구체적으로 이름 붙일 수 있습니다 — 오리, 거위, 올빼미, 칠면조, 닭, 수탉. Apple이 오리를 듣고 팩에 오리 클래스가 없으면, 모델은 그 꽥 소리를 가장 가까운 종으로 억지로 넣고 틀린 새라고 확신합니다. 침묵 오경보가 아니라 오식별이고, gateClasses만으로는 막히지 않습니다 — 오리도 일반 bird 게이트를 건드리기 때문입니다.

muteClasses가 고칩니다: Apple이 이 라벨 중 하나에 확신하면, 그 순간 팩은 조용히 있고 Apple의 구체적 판정에 맡깁니다. 다루지 않는 소리의 기본 라벨을 나열하세요:

"muteClasses": ["owl_hoot", "duck_quack", "goose_honk", "turkey_gobble", "chicken", "chicken_cluck", "rooster_crow"]

경험 법칙: 특정 Apple 새 라벨은, 모델에 맞는(또는 더 나은) 클래스가 있으면 **gateClasses**에, 없으면 **muteClasses**에 넣습니다. Apple이 이름 붙일 수 있고 당신은 못 하는 모든 것 → mute하고, Apple이 맞게 하도록 하세요.

4단계 — profiles.json 작성 (선택, 권장)

앱에서 각 소리가 어떻게 보이고 느껴질지를 제어합니다 — 클래스당 항목 하나, 정확한 폴더/라벨 이름을 키로:

{
  "Mourning_Dove": {
    "displayName": "Mourning Dove",
    "hapticCount": 1,
    "emergencyTier": "none",
    "category": "animal",
    "icon": "bird",
    "color": "teal",
    "threshold": 0.5,
    "maxRange": 150
  },
  "House_Finch": {
    "displayName": "House Finch",
    "hapticCount": 1,
    "category": "animal",
    "icon": "bird"
  },
  "Background": {
    "category": "ignored",
    "threshold": 1.1
  }
}

모든 키는 선택 — 생략하면 합리적인 기본값이 적용됩니다:

Background 클래스에는 위에 나온 특수 항목이 필요합니다: "threshold": 1.1이면 보고가 불가능합니다(신뢰도가 1.0을 넘지 않음). 주변 오디오를 조용히 흡수하고 감지로 나타나지 않습니다. 그냥 생략하지 마세요 — 목록에 없는 클래스도 기본 threshold 0.5를 받아 일반 소리로 앱에 나타날 수 있습니다.

5단계 — Zip으로 묶기

세 파일 — pack.json, profiles.json, model.mlmodel — 을 선택하고 우클릭한 뒤 Compress합니다. 감싼 폴더를 zip해도 됩니다; 앱은 한 단계 아래까지 찾습니다.

MyPack.zip
├── pack.json
├── profiles.json
└── model.mlmodel

zip을 iPhone으로 옮기는 방법은 자유입니다: AirDrop, iCloud Drive, Mail, Messages.

6단계 — iPhone에서 가져오기

1. Vigilant Ear 열기 → 톱니 메뉴 → Power Pack+.
2. **Custom Sound Packs (BYOM)**까지 스크롤하고 **Import Custom Pack (.zip)**을 탭합니다.
3. Files 브라우저에서 zip을 고릅니다.

팩이 소리 개수와 함께 목록에 나타나며, 이미 LIVE입니다. 여기서 할 수 있는 것:

• LIVE / OFF — 삭제 없이 팩을 켜고 끕니다. Off는 배터리를 쓰지 않습니다.
• Delete — 5초 카운트다운이 시작되고(다시 탭하면 취소), 팩을 완전히 제거합니다.
• 원하는 만큼 팩을 가져올 수 있으며, 모두 기본 감지기와 함께 동작합니다. 켜 둔 팩마다 배터리를 쓰므로, 쓰지 않는 팩은 끄세요.

감지된 소리는 다른 것과 같습니다: 아이콘·색의 지도 점, 알림의 display name, 설정한 햅틱.

알아 둘 기본 동작: 커스텀 팩 감지는 Constellation 메시 피어로 전달되지 않습니다(다른 폰에는 팩이 없음). 또한 팩 소리는 알림 전에 연속 두 번 감지가 필요해, 한 프레임 오탐을 걸러 냅니다.

문제 해결

팩 업데이트

다시 학습하거나 수정한 뒤, 다시 zip하고 pack.json의 같은 id로 가져오면 — 이전 버전이 그 자리에서 교체됩니다.

Appendix: Built-in Sound Identifiers (iOS 26.5)

아래는 Apple 온디바이스 Sound Analysis 분류기가 인식하는 기본 사운드 카테고리 — 위에서 gateClasses와 muteClasses에 쓸 수 있는 라벨입니다. Apple은 더 이상 개발자 사이트에 이 목록을 게시하지 않으므로, 아래 표는 기기 분류기(SNClassifierIdentifier.version1)에서 직접 읽은 것입니다.

2026년 7월 기준 알려진 분류 (iOS 26.5) — 라벨 303개. Apple은 OS 업데이트에서 추가·삭제·이름 변경할 수 있으므로, 시점 스냅샷으로 보세요: 이후 OS에서 빠진 라벨에 게이트하면 그 게이트는 절대 안 울리고(팩은 조용), 새로 추가된 라벨은 게이트하기 전까지 존재하지 않습니다. 표시된 철자를 그대로 쓰세요(소문자, 밑줄).

© 2026 Wingdings, Inc.
All rights reserved.
Patent Pending