播放音訊

Posted on 8 月 04, 2026 by

點擊卡片就可以播放音訊。

請先把 mp3 音訊檔案放到 www/audio 資料夾底下

這只是示範專案，只要把 b.mp3 放到這個資料夾即可。

方式1‑HTML5 播放

透過 WebView 支援的 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 外掛 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 教學

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *