사운드 가이드

이 가이드를 시작하기 전에 기본 사용법을 완료하세요.

개요

@petify/react-native-camera-ui는 반려동물의 주의를 끌기 위한 6가지 사운드를 내장하고 있습니다. PetnowSound API를 사용하여 촬영 중 반려동물이 카메라를 보도록 유도할 수 있습니다. 카메라와 독립적으로 동작하므로 카메라 뷰가 없어도 재생됩니다.

사용 가능한 사운드

전체 사운드 목록

사운드 미리듣기

각 사운드를 클릭하여 미리 들어볼 수 있습니다. 반려동물의 반응을 테스트해보세요!

사운드	설명	대상
🥔 `bagOfChips`	과자 봉지 바스락 소리	🐕🐱 모두
🥫 `openingCan`	캔 따는 소리	🐕🐱 모두
🍚 `pouringFood`	사료 따르는 소리	🐕🐱 모두
🥣 `shakers`	사료 흔드는 소리	🐕🐱 모두
🧸 `squeakyToy`	삑삑이 장난감 소리	🐕 강아지
😽 `pspsps`	프스프스 소리	🐱 고양이

기본 사용법

사운드를 재생하기 전에 prepare()로 샘플을 한 번 로드합니다.

import { PetnowSound } from '@petify/react-native-camera-ui';

await PetnowSound.prepare(); // 샘플 로드(최초 1회)

1. 랜덤 사운드 재생

종에 맞는 사운드를 자동으로 선택하여 재생합니다.

// 강아지용 랜덤 사운드
const handle = PetnowSound.play('random', 'DOG');

// 고양이용 랜덤 사운드
const handle = PetnowSound.play('random', 'CAT');

2. 특정 사운드 재생

원하는 사운드를 직접 선택하여 재생합니다.

// 삑삑이 소리 재생
const handle = PetnowSound.play('squeakyToy', 'DOG');

// 프스프스 소리 재생
const handle = PetnowSound.play('pspsps', 'CAT');

3. 사운드 중지

사운드를 중지하려면 재생 시 반환된 핸들을 보관해두어야 합니다.

// ⚠️ 이렇게 하면 stop()을 호출할 수 없음
PetnowSound.play('squeakyToy', 'DOG');  // 반환 핸들 무시

// ✅ 중지하려면 핸들을 보관
const handle = PetnowSound.play('squeakyToy', 'DOG');
// ... 나중에
PetnowSound.stop(handle);

play()가 -1을 반환하면 재생되지 않은 것입니다(prepare() 미호출 또는 종에 맞지 않는 사운드). 이 경우 stop()은 아무 동작도 하지 않습니다.

4. 자원 해제

사운드를 더 사용하지 않으면 네이티브 오디오 자원을 해제합니다.

PetnowSound.release();

메서드 요약

메서드	설명
`prepare()`	샘플 로드(`Promise`). `play` 전에 1회 — 마운트 시점 등 미리 호출 권장. iOS는 온디맨드(즉시 resolve), Android는 미리 적재 후 로딩 완료 시 resolve
`play(sound, species)`	재생 후 정지 핸들(`number`, ≥0) 반환. 미준비/미매핑 시 `-1`
`stop(handle)`	핸들로 정지
`release()`	네이티브 오디오 자원 해제

sound: 'random'(종에 맞는 후보 선택) | 'pouringFood' | 'bagOfChips' | 'openingCan' | 'squeakyToy' | 'pspsps' | 'shakers'
species: 'DOG' | 'CAT' — 'random'의 후보 선택에 사용합니다(그 외 사운드는 무시).

다음 단계

기본 사용법 — usePetnowCamera + CameraView, 이벤트·커맨드·수명주기
커스터마이징 — <CameraView> 위에 가이드·버튼·결과 UI 올리기

사운드 가이드

On this page