오디오 재생

Posted on 8월 04, 2026 by

카드를 클릭하면 오디오가 재생됩니다.

먼저 mp3 오디오 파일을 www/audio 디렉터리에 넣어주세요.

데모 프로젝트이므로 여기에 b.mp3 파일만 넣으면 됩니다.

방식1‑HTML5 재생

웹뷰에서 지원하는 HTML5 Audio로 오디오를 재생하며 플러그인이 필요하지 않습니다.

main.js 내용을 아래와 같이 수정합니다.

// 베트남어 자음 데이터
const consonants = [
    {char: "b", pronounce: "/ɓ/", desc: "양순 파열음"},
    {char: "c", pronounce: "/k/", desc: "경구개 파열음"},
    {char: "ch", pronounce: "/tɕ/", desc: "구개 파찰음"},
    {char: "d", pronounce: "/ɗ/", desc: "치경 파열음"},
    {char: "đ", pronounce: "/ɗ/", desc: "치경 유성 파열음"},
    {char: "g", pronounce: "/ɣ/", desc: "구개 마찰음"},
    {char: "gh", pronounce: "/ɣ/", desc: "e, i 앞에서 사용"},
    {char: "h", pronounce: "/h/", desc: "성문 마찰음"},
    {char: "k", pronounce: "/k/", desc: "경구개 무성 파열음"},
    {char: "kh", pronounce: "/x/", desc: "경구개 마찰음"},
    {char: "l", pronounce: "/l/", desc: "치경 설측음"},
    {char: "m", pronounce: "/m/", desc: "양순 비음"},
    {char: "n", pronounce: "/n/", desc: "치경 비음"},
    {char: "ng", pronounce: "/ŋ/", desc: "연구개 비음"},
    {char: "ngh", pronounce: "/ŋ/", desc: "e,i 앞에서 사용"},
    {char: "nh", pronounce: "/ɲ/", desc: "구개 비음"},
    {char: "p", pronounce: "/p/", desc: "무기 양순 파열음"},
    {char: "ph", pronounce: "/f/", desc: "순치 마찰음"},
    {char: "q", pronounce: "/kw/", desc: "항상 u와 함께 사용"},
    {char: "r", pronounce: "/r/", desc: "치경 진동음"},
    {char: "s", pronounce: "/s/", desc: "치경 마찰음"},
    {char: "t", pronounce: "/t/", desc: "치경 파열음"},
    {char: "th", pronounce: "/θ/", desc: "치 마찰음"},
    {char: "v", pronounce: "/v/", desc: "순치 유성 마찰음"},
    {char: "x", pronounce: "/s/", desc: "치경 마찰음"}
];

let favList = JSON.parse(localStorage.getItem("vn_consonant_fav")) || [];
let currentAudio = null; // 전역 오디오 객체, 이전 재생 중지용

const gridEl = document.getElementById("consonant-grid");
const favGridEl = document.getElementById("favorite-grid");
const modal = document.getElementById("modal");
const modalChar = document.getElementById("modal-char");
const modalPro = document.getElementById("modal-pronounce");
const modalDesc = document.getElementById("modal-desc");
const btnFav = document.getElementById("btn-fav");
const closeModal = document.getElementById("close-modal");

let currentItem = null;

// ====================== MP3 재생 함수 ======================
function playAudio(charName) {
    // 재생 중인 소리 중지
    if(currentAudio){
        currentAudio.pause();
        currentAudio.currentTime = 0;
    }
    // 오디오 생성
    currentAudio = new Audio(`audio/${charName}.mp3`);
    currentAudio.volume = 1;
    currentAudio.play().catch(err=>{
        console.log("파일 재생 실패: ", charName, err);
        alert(`오디오 파일을 찾을 수 없습니다: ${charName}.mp3`);
    });
}

// 자음 카드 렌더링
function renderCards(){
    gridEl.innerHTML = "";
    consonants.forEach(item=>{
        const div = document.createElement("div");
        div.className = "bg-cardBg rounded-lg py-5 text-center card-shadow active:scale-95 transition-transform cursor-pointer";
        div.innerHTML = `<span class="text-2xl font-bold text-gray-800">${item.char}</span>`;
        div.onclick = ()=> {
            playAudio(item.char); // 카드 클릭 시 mp3 재생
            openModal(item);
        };
        gridEl.appendChild(div);
    })
}

// 즐겨찾기 페이지 렌더링
function renderFav(){
    favGridEl.innerHTML = "";
    if(favList.length === 0){
        favGridEl.innerHTML = `<p class="col-span-3 text-center text-gray-400 py-10">즐겨찾기 항목이 없습니다</p>`;
        return;
    }
    favList.forEach(item=>{
        const div = document.createElement("div");
        div.className = "bg-cardBg rounded-lg py-5 text-center card-shadow active:scale-95 transition-transform cursor-pointer";
        div.innerHTML = `<span class="text-2xl font-bold text-gray-800">${item.char}</span>`;
        div.onclick = ()=> {
            playAudio(item.char);
            openModal(item);
        };
        favGridEl.appendChild(div);
    })
}

// 상세 팝업 열기
function openModal(item){
    currentItem = item;
    modalChar.innerText = item.char;
    modalPro.innerText = item.pronounce;
    modalDesc.innerText = item.desc;
    updateFavButton();
    modal.classList.remove("hidden");
}

// 팝업 닫기
closeModal.onclick = ()=>{
    modal.classList.add("hidden");
}
modal.onclick = (e)=>{
    if(e.target === modal) modal.classList.add("hidden");
}

// 즐겨찾기 추가/삭제 버튼
function updateFavButton(){
    const exist = favList.find(x=>x.char === currentItem.char);
    btnFav.innerText = exist ? "즐겨찾기에서 삭제" : "즐겨찾기에 추가";
}
btnFav.onclick = ()=>{
    const idx = favList.findIndex(x=>x.char === currentItem.char);
    if(idx >=0) favList.splice(idx,1);
    else favList.push(currentItem);
    localStorage.setItem("vn_consonant_fav", JSON.stringify(favList));
    updateFavButton();
    renderFav();
}

// 탭 페이지 전환
const tabBtns = document.querySelectorAll(".tab-btn");
const pages = document.querySelectorAll(".page");
tabBtns.forEach(btn=>{
    btn.onclick = ()=>{
        const targetId = btn.dataset.target;
        tabBtns.forEach(b=>{
            b.classList.remove("tab-active");
            b.querySelector("svg").classList.add("text-gray-500");
        })
        btn.classList.add("tab-active");
        btn.querySelector("svg").classList.remove("text-gray-500");
        pages.forEach(p=>p.classList.add("hidden"));
        document.getElementById(targetId).classList.remove("hidden");
    }
})

document.addEventListener("DOMContentLoaded", ()=>{
    renderCards();
    renderFav();
})

document.addEventListener("deviceready", ()=>{
    console.log("Cordova 준비 완료");
}, false);Code language: JavaScript (javascript)

방식2‑플러그인 재생

cordova‑plugin‑media 플러그인으로 재생합니다.

플러그인 설치

cordova plugin add cordova-plugin-media

실행 과정

D:\cordovademo\hello>cordova plugin add cordova-plugin-media
Installing "cordova-plugin-media" for android
Installing "cordova-plugin-file" for android
Subproject Path: CordovaLib
Subproject Path: app

The Android Persistent storage location now defaults to "Internal". Please check this plugin's README to see if your application needs any changes in its config.xml.

If this is a new application no changes are required.

If this is an update to an existing application that did not specify an "AndroidPersistentFileLocation" you may need to add:

      "<preference name="AndroidPersistentFileLocation" value="Compatibility" />"

to config.xml in order for the application to find previously stored files.

Adding cordova-plugin-media to package.jsonCode language: HTML, XML (xml)

오디오 재생 함수 교체

let mediaPlayer = null;

function playAudio(charName) {
    // 이전 파일 중지
    if(mediaPlayer){
        mediaPlayer.stop();
        mediaPlayer.release();
        mediaPlayer = null;
    }
    // 중요: Cordova Android 경로 www/audio/
    const src = `audio/${charName}.mp3`;
    mediaPlayer = new Media(src,
        ()=>{
            // 재생 완료 후 리소스 해제
            mediaPlayer.release();
            mediaPlayer = null;
        },
        (err)=>{
            console.error("오디오 재생 오류", err);
        }
    );
    mediaPlayer.play();
}Code language: JavaScript (javascript)

위 코드를 기존 main.js의 메서드로 교체하세요.

// 베트남어 자음 데이터
const consonants = [
    {char: "b", pronounce: "/ɓ/", desc: "양순 파열음"},
    {char: "c", pronounce: "/k/", desc: "경구개 파열음"},
    {char: "ch", pronounce: "/tɕ/", desc: "구개 파찰음"},
    {char: "d", pronounce: "/ɗ/", desc: "치경 파열음"},
    {char: "đ", pronounce: "/ɗ/", desc: "치경 유성 파열음"},
    {char: "g", pronounce: "/ɣ/", desc: "구개 마찰음"},
    {char: "gh", pronounce: "/ɣ/", desc: "e, i 앞에서 사용"},
    {char: "h", pronounce: "/h/", desc: "성문 마찰음"},
    {char: "k", pronounce: "/k/", desc: "경구개 무성 파열음"},
    {char: "kh", pronounce: "/x/", desc: "경구개 마찰음"},
    {char: "l", pronounce: "/l/", desc: "치경 설측음"},
    {char: "m", pronounce: "/m/", desc: "양순 비음"},
    {char: "n", pronounce: "/n/", desc: "치경 비음"},
    {char: "ng", pronounce: "/ŋ/", desc: "연구개 비음"},
    {char: "ngh", pronounce: "/ŋ/", desc: "e,i 앞에서 사용"},
    {char: "nh", pronounce: "/ɲ/", desc: "구개 비음"},
    {char: "p", pronounce: "/p/", desc: "무기 양순 파열음"},
    {char: "ph", pronounce: "/f/", desc: "순치 마찰음"},
    {char: "q", pronounce: "/kw/", desc: "항상 u와 함께 사용"},
    {char: "r", pronounce: "/r/", desc: "치경 진동음"},
    {char: "s", pronounce: "/s/", desc: "치경 마찰음"},
    {char: "t", pronounce: "/t/", desc: "치경 파열음"},
    {char: "th", pronounce: "/θ/", desc: "치 마찰음"},
    {char: "v", pronounce: "/v/", desc: "순치 유성 마찰음"},
    {char: "x", pronounce: "/s/", desc: "치경 마찰음"}
];

let favList = JSON.parse(localStorage.getItem("vn_consonant_fav")) || [];
let currentAudio = null; // 전역 오디오 객체, 이전 재생 중지용

const gridEl = document.getElementById("consonant-grid");
const favGridEl = document.getElementById("favorite-grid");
const modal = document.getElementById("modal");
const modalChar = document.getElementById("modal-char");
const modalPro = document.getElementById("modal-pronounce");
const modalDesc = document.getElementById("modal-desc");
const btnFav = document.getElementById("btn-fav");
const closeModal = document.getElementById("close-modal");

let currentItem = null;

// ====================== MP3 재생 함수 ======================
let mediaPlayer = null;

function playAudio(charName) {
    // 이전 파일 중지
    if(mediaPlayer){
        mediaPlayer.stop();
        mediaPlayer.release();
        mediaPlayer = null;
    }
    // 중요: Cordova Android 경로 www/audio/
    const src = `audio/${charName}.mp3`;
    mediaPlayer = new Media(src,
        ()=>{
            // 재생 완료 후 리소스 해제
            mediaPlayer.release();
            mediaPlayer = null;
        },
        (err)=>{
            console.error("오디오 재생 오류", err);
        }
    );
    mediaPlayer.play();
}

// 자음 카드 렌더링
function renderCards(){
    gridEl.innerHTML = "";
    consonants.forEach(item=>{
        const div = document.createElement("div");
        div.className = "bg-cardBg rounded-lg py-5 text-center card-shadow active:scale-95 transition-transform cursor-pointer";
        div.innerHTML = `<span class="text-2xl font-bold text-gray-800">${item.char}</span>`;
        div.onclick = ()=> {
            playAudio(item.char); // 카드 클릭 시 mp3 재생
            openModal(item);
        };
        gridEl.appendChild(div);
    })
}

// 즐겨찾기 페이지 렌더링
function renderFav(){
    favGridEl.innerHTML = "";
    if(favList.length === 0){
        favGridEl.innerHTML = `<p class="col-span-3 text-center text-gray-400 py-10">즐겨찾기 항목이 없습니다</p>`;
        return;
    }
    favList.forEach(item=>{
        const div = document.createElement("div");
        div.className = "bg-cardBg rounded-lg py-5 text-center card-shadow active:scale-95 transition-transform cursor-pointer";
        div.innerHTML = `<span class="text-2xl font-bold text-gray-800">${item.char}</span>`;
        div.onclick = ()=> {
            playAudio(item.char);
            openModal(item);
        };
        favGridEl.appendChild(div);
    })
}

// 상세 팝업 열기
function openModal(item){
    currentItem = item;
    modalChar.innerText = item.char;
    modalPro.innerText = item.pronounce;
    modalDesc.innerText = item.desc;
    updateFavButton();
    modal.classList.remove("hidden");
}

// 팝업 닫기
closeModal.onclick = ()=>{
    modal.classList.add("hidden");
}
modal.onclick = (e)=>{
    if(e.target === modal) modal.classList.add("hidden");
}

// 즐겨찾기 추가/삭제 버튼
function updateFavButton(){
    const exist = favList.find(x=>x.char === currentItem.char);
    btnFav.innerText = exist ? "즐겨찾기에서 삭제" : "즐겨찾기에 추가";
}
btnFav.onclick = ()=>{
    const idx = favList.findIndex(x=>x.char === currentItem.char);
    if(idx >=0) favList.splice(idx,1);
    else favList.push(currentItem);
    localStorage.setItem("vn_consonant_fav", JSON.stringify(favList));
    updateFavButton();
    renderFav();
}

// 탭 페이지 전환
const tabBtns = document.querySelectorAll(".tab-btn");
const pages = document.querySelectorAll(".page");
tabBtns.forEach(btn=>{
    btn.onclick = ()=>{
        const targetId = btn.dataset.target;
        tabBtns.forEach(b=>{
            b.classList.remove("tab-active");
            b.querySelector("svg").classList.add("text-gray-500");
        })
        btn.classList.add("tab-active");
        btn.querySelector("svg").classList.remove("text-gray-500");
        pages.forEach(p=>p.classList.add("hidden"));
        document.getElementById(targetId).classList.remove("hidden");
    }
})

document.addEventListener("DOMContentLoaded", ()=>{
    renderCards();
    renderFav();
})

document.addEventListener("deviceready", ()=>{
    console.log("Cordova 준비 완료");
}, false);Code language: JavaScript (javascript)

오디오 재생

Posted in Cordova 튜토리얼

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다