fix(audio): 웹 자동재생 정책 대응 및 모바일 바로 재생
- 웹에서 사용자 상호작용 전 BGM 대기 상태로 저장 - SFX 재생 또는 클릭 시 대기 중 BGM 자동 재생 - 모바일/데스크톱에서는 자동재생 제한 없이 바로 재생 - notifyUserInteraction() 메서드 추가
This commit is contained in:
@@ -33,6 +33,12 @@ class AudioService {
|
|||||||
// 초기화 실패 여부 (WASM 등에서 오디오 지원 안됨)
|
// 초기화 실패 여부 (WASM 등에서 오디오 지원 안됨)
|
||||||
bool _initFailed = false;
|
bool _initFailed = false;
|
||||||
|
|
||||||
|
// 웹에서 사용자 상호작용 대기 중인 BGM (자동재생 정책 대응)
|
||||||
|
String? _pendingBgm;
|
||||||
|
|
||||||
|
// 사용자 상호작용 발생 여부 (웹 자동재생 정책 우회용)
|
||||||
|
bool _userInteracted = false;
|
||||||
|
|
||||||
/// 서비스 초기화
|
/// 서비스 초기화
|
||||||
Future<void> init() async {
|
Future<void> init() async {
|
||||||
if (_initialized || _initFailed) return;
|
if (_initialized || _initFailed) return;
|
||||||
@@ -55,7 +61,11 @@ class AudioService {
|
|||||||
}
|
}
|
||||||
|
|
||||||
_initialized = true;
|
_initialized = true;
|
||||||
if (kIsWeb) {
|
|
||||||
|
// 모바일/데스크톱에서는 자동재생 제한 없음
|
||||||
|
if (!kIsWeb) {
|
||||||
|
_userInteracted = true;
|
||||||
|
} else {
|
||||||
debugPrint('[AudioService] Initialized on Web platform');
|
debugPrint('[AudioService] Initialized on Web platform');
|
||||||
}
|
}
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
@@ -68,6 +78,9 @@ class AudioService {
|
|||||||
///
|
///
|
||||||
/// [name]은 assets/audio/bgm/ 폴더 내 파일명 (확장자 제외)
|
/// [name]은 assets/audio/bgm/ 폴더 내 파일명 (확장자 제외)
|
||||||
/// 예: playBgm('battle') → assets/audio/bgm/battle.mp3
|
/// 예: playBgm('battle') → assets/audio/bgm/battle.mp3
|
||||||
|
///
|
||||||
|
/// 웹에서 사용자 상호작용 없이 호출되면 대기 상태로 저장되고,
|
||||||
|
/// 다음 SFX 재생 시 함께 시작됩니다.
|
||||||
Future<void> playBgm(String name) async {
|
Future<void> playBgm(String name) async {
|
||||||
if (_initFailed) return; // 초기화 실패 시 무시
|
if (_initFailed) return; // 초기화 실패 시 무시
|
||||||
if (!_initialized) await init();
|
if (!_initialized) await init();
|
||||||
@@ -75,13 +88,20 @@ class AudioService {
|
|||||||
if (_currentBgm == name) return; // 이미 재생 중
|
if (_currentBgm == name) return; // 이미 재생 중
|
||||||
|
|
||||||
try {
|
try {
|
||||||
_currentBgm = name;
|
|
||||||
await _bgmPlayer!.setAsset('assets/audio/bgm/$name.mp3');
|
await _bgmPlayer!.setAsset('assets/audio/bgm/$name.mp3');
|
||||||
await _bgmPlayer!.play();
|
await _bgmPlayer!.play();
|
||||||
|
_currentBgm = name;
|
||||||
|
_pendingBgm = null;
|
||||||
|
_userInteracted = true; // 재생 성공 → 상호작용 확인됨
|
||||||
debugPrint('[AudioService] Playing BGM: $name');
|
debugPrint('[AudioService] Playing BGM: $name');
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
// 파일이 없으면 무시 (개발 중 에셋 미추가 상태)
|
// 웹 자동재생 정책으로 실패 시 대기 상태로 저장
|
||||||
debugPrint('[AudioService] Failed to play BGM $name: $e');
|
if (kIsWeb && e.toString().contains('NotAllowedError')) {
|
||||||
|
_pendingBgm = name;
|
||||||
|
debugPrint('[AudioService] BGM $name pending (waiting for user interaction)');
|
||||||
|
} else {
|
||||||
|
debugPrint('[AudioService] Failed to play BGM $name: $e');
|
||||||
|
}
|
||||||
_currentBgm = null;
|
_currentBgm = null;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -112,6 +132,8 @@ class AudioService {
|
|||||||
///
|
///
|
||||||
/// [name]은 assets/audio/sfx/ 폴더 내 파일명 (확장자 제외)
|
/// [name]은 assets/audio/sfx/ 폴더 내 파일명 (확장자 제외)
|
||||||
/// 예: playSfx('attack') → assets/audio/sfx/attack.mp3
|
/// 예: playSfx('attack') → assets/audio/sfx/attack.mp3
|
||||||
|
///
|
||||||
|
/// 웹에서 대기 중인 BGM이 있으면 함께 재생 시작합니다.
|
||||||
Future<void> playSfx(String name) async {
|
Future<void> playSfx(String name) async {
|
||||||
if (_initFailed) return; // 초기화 실패 시 무시
|
if (_initFailed) return; // 초기화 실패 시 무시
|
||||||
if (!_initialized) await init();
|
if (!_initialized) await init();
|
||||||
@@ -119,6 +141,15 @@ class AudioService {
|
|||||||
if (_sfxVolume == 0) return; // 볼륨이 0이면 재생 안함
|
if (_sfxVolume == 0) return; // 볼륨이 0이면 재생 안함
|
||||||
if (_sfxPlayers.isEmpty) return;
|
if (_sfxPlayers.isEmpty) return;
|
||||||
|
|
||||||
|
// 웹에서 대기 중인 BGM 재생 시도 (사용자 상호작용 발생)
|
||||||
|
if (!_userInteracted && _pendingBgm != null) {
|
||||||
|
_userInteracted = true;
|
||||||
|
final pending = _pendingBgm;
|
||||||
|
_pendingBgm = null;
|
||||||
|
// BGM 재생 (비동기로 진행)
|
||||||
|
playBgm(pending!);
|
||||||
|
}
|
||||||
|
|
||||||
// 사용 가능한 플레이어 찾기
|
// 사용 가능한 플레이어 찾기
|
||||||
AudioPlayer? availablePlayer;
|
AudioPlayer? availablePlayer;
|
||||||
for (final player in _sfxPlayers) {
|
for (final player in _sfxPlayers) {
|
||||||
@@ -170,6 +201,21 @@ class AudioService {
|
|||||||
/// 현재 재생 중인 BGM
|
/// 현재 재생 중인 BGM
|
||||||
String? get currentBgm => _currentBgm;
|
String? get currentBgm => _currentBgm;
|
||||||
|
|
||||||
|
/// 사용자 상호작용 발생 알림 (웹 자동재생 정책 우회)
|
||||||
|
///
|
||||||
|
/// 버튼 클릭 등 사용자 상호작용 시 호출하면
|
||||||
|
/// 대기 중인 BGM이 재생됩니다.
|
||||||
|
Future<void> notifyUserInteraction() async {
|
||||||
|
if (_userInteracted) return;
|
||||||
|
_userInteracted = true;
|
||||||
|
|
||||||
|
if (_pendingBgm != null) {
|
||||||
|
final pending = _pendingBgm;
|
||||||
|
_pendingBgm = null;
|
||||||
|
await playBgm(pending!);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/// 서비스 정리
|
/// 서비스 정리
|
||||||
Future<void> dispose() async {
|
Future<void> dispose() async {
|
||||||
await _bgmPlayer?.dispose();
|
await _bgmPlayer?.dispose();
|
||||||
|
|||||||
Reference in New Issue
Block a user