PetnowiOS SDKUI 모듈
사운드 가이드
playSound 함수를 사용한 반려동물 주의 유도 사운드 재생.
개요
UI 모듈은 반려동물의 주의를 끌기 위한 6가지 사운드를 내장하고 있습니다. playSound() 함수를 사용하여 촬영 중 반려동물이 카메라를 보도록 유도할 수 있습니다.
사용 가능한 사운드
전체 사운드 목록
사운드 미리듣기
각 사운드를 클릭하여 미리 들어볼 수 있습니다. 반려동물의 반응을 테스트해보세요!
| 사운드 | 설명 | 대상 | 미리듣기 |
|---|---|---|---|
🥔 bagOfChips | 과자 봉지 바스락 소리 | 🐕🐱 모두 | |
🥫 openingCan | 캔 따는 소리 | 🐕🐱 모두 | |
🍚 pouringFood | 사료 따르는 소리 | 🐕🐱 모두 | |
🥣 shakeFood | 사료 흔드는 소리 | 🐕🐱 모두 | |
🧸 squeakyToy | 삑삑이 장난감 소리 | 🐕 강아지 | |
😽 pspspsSound | 프스프스 소리 | 🐱 고양이 |
기본 사용법
1. 랜덤 사운드 재생
종에 맞는 사운드를 자동으로 선택하여 재생합니다.
import PetnowUI
// 강아지용 랜덤 사운드
let player = try? playSound(.random(species: .dog))
// 고양이용 랜덤 사운드
let player = try? playSound(.random(species: .cat))2. 특정 사운드 재생
원하는 사운드를 직접 선택하여 재생합니다.
// 삑삑이 소리 재생
let player = try? playSound(.one(name: .squeakyToy))
// 프스프스 소리 재생
let player = try? playSound(.one(name: .pspspsSound))3. 사운드 중지
사운드를 중지하려면 PlayerType 객체를 보관해두어야 합니다.
// ⚠️ 이렇게 하면 stop()을 호출할 수 없음
try? playSound(.one(name: .squeakyToy)) // 반환값 무시
// ✅ stop()을 호출하려면 player를 보관
let player = try? playSound(.one(name: .squeakyToy))
// ... 나중에
player?.stop()4. 재생 시점 제어하기 (makePlayer)
playSound()는 호출 즉시 재생됩니다. 재생 시점을 직접 제어하거나, 플레이어 객체를 미리 준비해두려면 makePlayer(type:) 함수를 사용하세요.
// 플레이어만 생성 (아직 재생되지 않음)
let player = try? makePlayer(type: .one(name: .bagOfChips))
// 원하는 시점에 재생
player?.play()
// 중지
player?.stop()언제 makePlayer를 사용하나요?
- 사운드를 미리 준비해두고 특정 이벤트에 재생하고 싶을 때
- 재생 중인 사운드를 중지해야 할 때
- 같은 사운드를 반복 재생해야 할 때
PlayerType 프로토콜
playSound()와 makePlayer()는 모두 PlayerType 프로토콜을 준수하는 객체를 반환합니다.
public protocol PlayerType {
func play() // 재생 (처음부터)
func stop() // 중지 및 처음으로 되감기
}