Lire l’audio

Nous devons cliquer sur la carte pour lire l’audio.

Veuillez d’abord placer le fichier audio mp3 dans le répertoire www/audio

Il s’agit d’un projet de démonstration, il suffit donc de placer un fichier b.mp3 dans ce dossier.

Méthode 1 : Lecture HTML5

La lecture audio s’effectue via l’API HTML5 Audio prise en charge par WebView, sans plugin nécessaire

Modifiez le contenu de main.js comme ci‑dessous

// Données des consonnes vietnamiennes
const consonants = [
    {char: "b", pronounce: "/ɓ/", desc: "Consonne occlusive bilabiale injectée"},
    {char: "c", pronounce: "/k/", desc: "Consonne vélaire dure"},
    {char: "ch", pronounce: "/tɕ/", desc: "Consonne affriquée palatale"},
    {char: "d", pronounce: "/ɗ/", desc: "Consonne occlusive alvéolaire injectée"},
    {char: "đ", pronounce: "/ɗ/", desc: "Consonne implosive alvéolaire"},
    {char: "g", pronounce: "/ɣ/", desc: "Consonne fricative vélaire"},
    {char: "gh", pronounce: "/ɣ/", desc: "Utilisé devant e, i"},
    {char: "h", pronounce: "/h/", desc: "Consonne fricative glottale"},
    {char: "k", pronounce: "/k/", desc: "Consonne occlusive vélaire dure"},
    {char: "kh", pronounce: "/x/", desc: "Consonne fricative vélaire dure"},
    {char: "l", pronounce: "/l/", desc: "Consonne latérale alvéolaire"},
    {char: "m", pronounce: "/m/", desc: "Consonne nasale bilabiale"},
    {char: "n", pronounce: "/n/", desc: "Consonne nasale alvéolaire"},
    {char: "ng", pronounce: "/ŋ/", desc: "Consonne nasale vélaire molle"},
    {char: "ngh", pronounce: "/ŋ/", desc: "Utilisé devant e,i"},
    {char: "nh", pronounce: "/ɲ/", desc: "Consonne nasale palatale"},
    {char: "p", pronounce: "/p/", desc: "Consonne occlusive bilabiale non injectée"},
    {char: "ph", pronounce: "/f/", desc: "Consonne fricative labio‑dentale"},
    {char: "q", pronounce: "/kw/", desc: "Toujours associé à u"},
    {char: "r", pronounce: "/r/", desc: "Consonne roulée alvéolaire"},
    {char: "s", pronounce: "/s/", desc: "Consonne fricative alvéolaire"},
    {char: "t", pronounce: "/t/", desc: "Consonne occlusive alvéolaire"},
    {char: "th", pronounce: "/θ/", desc: "Consonne fricative dentale"},
    {char: "v", pronounce: "/v/", desc: "Consonne fricative labio‑dentale"},
    {char: "x", pronounce: "/s/", desc: "Consonne fricative alvéolaire"}
];

let favList = JSON.parse(localStorage.getItem("vn_consonant_fav")) || [];
let currentAudio = null; // Objet audio global, pour arrêter la lecture précédente

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;

// ====================== FONCTION DE LECTURE MP3 ======================
function playAudio(charName) {
    // Arrêter l’audio en cours de lecture
    if(currentAudio){
        currentAudio.pause();
        currentAudio.currentTime = 0;
    }
    // Créer l’objet audio
    currentAudio = new Audio(`audio/${charName}.mp3`);
    currentAudio.volume = 1;
    currentAudio.play().catch(err=>{
        console.log("Échec de lecture du fichier : ", charName, err);
        alert(`Fichier audio introuvable : ${charName}.mp3`);
    });
}

// Générer l’affichage des cartes de consonnes
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); // Clic sur la carte pour lire le mp3
            openModal(item);
        };
        gridEl.appendChild(div);
    })
}

// Générer la page des favoris
function renderFav(){
    favGridEl.innerHTML = "";
    if(favList.length === 0){
        favGridEl.innerHTML = `<p class="col-span-3 text-center text-gray-400 py-10">Aucun favori enregistré</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);
    })
}

// Ouvrir la fenêtre popup de détails
function openModal(item){
    currentItem = item;
    modalChar.innerText = item.char;
    modalPro.innerText = item.pronounce;
    modalDesc.innerText = item.desc;
    updateFavButton();
    modal.classList.remove("hidden");
}

// Fermer la fenêtre popup
closeModal.onclick = ()=>{
    modal.classList.add("hidden");
}
modal.onclick = (e)=>{
    if(e.target === modal) modal.classList.add("hidden");
}

// Bouton ajouter/supprimer des favoris
function updateFavButton(){
    const exist = favList.find(x=>x.char === currentItem.char);
    btnFav.innerText = exist ? "Retirer des favoris" : "Ajouter aux favoris";
}
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();
}

// Onglets pour changer de page
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 est prêt");
}, false);Langage du code : JavaScript (javascript)

Méthode 2 : Lecture par plugin

Lecture à l’aide du plugin cordova‑plugin‑media de Cordova

Installation du plugin

cordova plugin add cordova-plugin-media

Sortie d’exécution

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.jsonLangage du code : HTML, XML (xml)

Remplacer la fonction de lecture audio

let mediaPlayer = null;

function playAudio(charName) {
    // Arrêter l’ancien fichier audio
    if(mediaPlayer){
        mediaPlayer.stop();
        mediaPlayer.release();
        mediaPlayer = null;
    }
    // Important : Chemin Cordova Android www/audio/
    const src = `audio/${charName}.mp3`;
    mediaPlayer = new Media(src,
        ()=>{
            // Libérer les ressources après la lecture
            mediaPlayer.release();
            mediaPlayer = null;
        },
        (err)=>{
            console.error("Erreur de lecture audio", err);
        }
    );
    mediaPlayer.play();
}Langage du code : JavaScript (javascript)

Remplacez l’ancienne fonction dans votre fichier main.js par ce code

// Données des consonnes vietnamiennes
const consonants = [
    {char: "b", pronounce: "/ɓ/", desc: "Consonne occlusive bilabiale injectée"},
    {char: "c", pronounce: "/k/", desc: "Consonne vélaire dure"},
    {char: "ch", pronounce: "/tɕ/", desc: "Consonne affriquée palatale"},
    {char: "d", pronounce: "/ɗ/", desc: "Consonne occlusive alvéolaire injectée"},
    {char: "đ", pronounce: "/ɗ/", desc: "Consonne implosive alvéolaire"},
    {char: "g", pronounce: "/ɣ/", desc: "Consonne fricative vélaire"},
    {char: "gh", pronounce: "/ɣ/", desc: "Utilisé devant e, i"},
    {char: "h", pronounce: "/h/", desc: "Consonne fricative glottale"},
    {char: "k", pronounce: "/k/", desc: "Consonne occlusive vélaire dure"},
    {char: "kh", pronounce: "/x/", desc: "Consonne fricative vélaire dure"},
    {char: "l", pronounce: "/l/", desc: "Consonne latérale alvéolaire"},
    {char: "m", pronounce: "/m/", desc: "Consonne nasale bilabiale"},
    {char: "n", pronounce: "/n/", desc: "Consonne nasale alvéolaire"},
    {char: "ng", pronounce: "/ŋ/", desc: "Consonne nasale vélaire molle"},
    {char: "ngh", pronounce: "/ŋ/", desc: "Utilisé devant e,i"},
    {char: "nh", pronounce: "/ɲ/", desc: "Consonne nasale palatale"},
    {char: "p", pronounce: "/p/", desc: "Consonne occlusive bilabiale non injectée"},
    {char: "ph", pronounce: "/f/", desc: "Consonne fricative labio‑dentale"},
    {char: "q", pronounce: "/kw/", desc: "Toujours associé à u"},
    {char: "r", pronounce: "/r/", desc: "Consonne roulée alvéolaire"},
    {char: "s", pronounce: "/s/", desc: "Consonne fricative alvéolaire"},
    {char: "t", pronounce: "/t/", desc: "Consonne occlusive alvéolaire"},
    {char: "th", pronounce: "/θ/", desc: "Consonne fricative dentale"},
    {char: "v", pronounce: "/v/", desc: "Consonne fricative labio‑dentale"},
    {char: "x", pronounce: "/s/", desc: "Consonne fricative alvéolaire"}
];

let favList = JSON.parse(localStorage.getItem("vn_consonant_fav")) || [];
let currentAudio = null; // Objet audio global, pour arrêter la lecture précédente

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;

// ====================== FONCTION DE LECTURE MP3 ======================
let mediaPlayer = null;

function playAudio(charName) {
    // Arrêter l’ancien fichier audio
    if(mediaPlayer){
        mediaPlayer.stop();
        mediaPlayer.release();
        mediaPlayer = null;
    }
    // Important : Chemin Cordova Android www/audio/
    const src = `audio/${charName}.mp3`;
    mediaPlayer = new Media(src,
        ()=>{
            // Libérer les ressources après la lecture
            mediaPlayer.release();
            mediaPlayer = null;
        },
        (err)=>{
            console.error("Erreur de lecture audio", err);
        }
    );
    mediaPlayer.play();
}

// Générer l’affichage des cartes de consonnes
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); // Clic sur la carte pour lire le mp3
            openModal(item);
        };
        gridEl.appendChild(div);
    })
}

// Générer la page des favoris
function renderFav(){
    favGridEl.innerHTML = "";
    if(favList.length === 0){
        favGridEl.innerHTML = `<p class="col-span-3 text-center text-gray-400 py-10">Aucun favori enregistré</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);
    })
}

// Ouvrir la fenêtre popup de détails
function openModal(item){
    currentItem = item;
    modalChar.innerText = item.char;
    modalPro.innerText = item.pronounce;
    modalDesc.innerText = item.desc;
    updateFavButton();
    modal.classList.remove("hidden");
}

// Fermer la fenêtre popup
closeModal.onclick = ()=>{
    modal.classList.add("hidden");
}
modal.onclick = (e)=>{
    if(e.target === modal) modal.classList.add("hidden");
}

// Bouton ajouter/supprimer des favoris
function updateFavButton(){
    const exist = favList.find(x=>x.char === currentItem.char);
    btnFav.innerText = exist ? "Retirer des favoris" : "Ajouter aux favoris";
}
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();
}

// Onglets pour changer de page
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 est prêt");
}, false);Langage du code : JavaScript (javascript)

Lire l’audio