Audio a podcastové vložené prehrávače: Publikovanie s prepisom na prvom mieste

Vložený audio prehrávač je prehrateľná nahrávka s názvom, zhrnutím, dĺžkou, pripísaním autora, ovládacími prvkami a kompletným prepisom. Zahŕňa vlastné audio aj schválené podcastové prehrávače, ale prepis je kanonický indexovateľný artefakt a musí stránku sprístupniť aj vtedy, keď nikto nestlačí tlačidlo Prehrať.

Ako sme overili migráciu bez straty organickej návštevnosti
14-minútový rozhovor s technickým vedúcim, upravený pre zrozumiteľnosť a publikovaný s kapitolami označenými rečníkmi.
Prehrať epizódu · 14:06 · Prečítať prepis

Čitateľ pozná tému, formát, náročnosť a textovú alternatívu ešte pred prehrávaním. Produkcia pridáva natívne ovládacie prvky alebo schváleného poskytovateľa, pričom názov, zhrnutie a prepis zostávajú v počiatočnom HTML.

Prečo na tomto prvku záleží

Audio zachováva dôraz, váhanie, emócie, výslovnosť a interakciu medzi rečníkmi. Vďaka tomu je užitočné tam, kde je prednes súčasťou dôkazu, a umožňuje čitateľom počúvať počas vykonávania inej úlohy. Dĺžka im dáva čestný odhad náročnosti ešte predtým, než sa zaviažu.

Audio je tiež lineárne: poslucháč nevidí celý argument naraz a môže prehľadávať minúty, aby našiel jednu číslicu. Záhadný prehrávač žiada o čas predtým, než stanoví hodnotu, zatiaľ čo automatické prehrávanie upútava pozornosť. Použite popisný úvod, dĺžku, kapitoly pre dlhšie nahrávky, ovládacie prvky prehrávania a skenovateľný prepis.

Strojová extrahovateľnosť závisí od textu, nie od prehrávača. Od crawlerov a systémov umelej inteligencie nemožno očakávať, že budú streamovať audio, rozpoznávať každého rečníka alebo rozlišovať opravu od tvrdenia, ktoré opravuje. Publikujte kompletný prepis ako serverom vykreslené HTML s menami rečníkov, nadpismi, užitočnými časovými pečiatkami a citáciami pripojenými k tvrdeniam, ktoré podporujú. Metadáta opisujú nahrávku; nemôžu nahradiť jej obsah.

Pred výberom tohto komponentu použite pravidlá písania prvkov . Ich pravidlo priority je sémantické: ak je účelom bloku umožniť čitateľovi prehrať a preskúmať zmysluplné audio, použite typovaný audio prvok namiesto štylizovania odkazu alebo iframe. Naopak, nepridávajte audio komponent len preto, že šablóna stránky má prázdne miesto pre médiá.

Kedy ho použiť

Použite vložený audio prehrávač, keď počutie nahrávky pridáva dôkazy, výslovnosť, emócie alebo pohodlie, ktoré samotná próza nezachováva. Dobré príklady zahŕňajú epizódu podcastu, interview so zdrojom, ukážku orálnej histórie, výpoveď zákazníka, odbornú odpoveď, porovnanie zvuku produktu alebo objednanú audio verziu dlhého článku.

Nahrávka potrebuje stabilného vlastníka, povolenie na publikovanie, skontrolovaný prepis a jasný vzťah k stránke. Ak záleží len na 90 sekundách zo 40-minútového rozhovoru, použite úryvok alebo odkaz na kapitolu s časovou pečiatkou vedľa tvrdenia.

Blízke prípady vyžadujú iné riešenie:

• Video so zmysluplnými ukážkami: použite vložené video . Extrahovanie jeho audia zahadzuje vizuálne inštrukcie a vytvára neúplnú alternatívu.
• Citát z nahratého rozhovoru: citujte schválenú pasáž v próze a uveďte nahrávku ako zdroj. Celý prehrávač je zbytočný, keď redakčnou úlohou je pripísanie jedného výroku.
• Syntetické rozprávanie krátkej stránky: ponechajte text. Opakovanie 300 slov pridáva údržbu bez zlepšenia vyhľadateľnosti.
• Hudba do pozadia alebo dekoratívna zvuková kulisa: vynechajte z redakčného obsahu. Dekorácia nesmie súťažiť s rečou, automaticky sa prehrávať ani vytvárať problém skrytých ovládacích prvkov.
• Súbor na stiahnutie bez prehrávania na stránke: použite odkaz na súbor s formátom a veľkosťou. Nazvať to vloženým prehrávačom sľubuje ovládacie prvky, ktoré neexistujú.
• Živý stream: použite špeciálny vzor udalosti so stavom, harmonogramom, časovým pásmom a záložnou nahrávkou. Audio prvok s konečnou dĺžkou nemôže čestne opísať neohraničené vysielanie.
• Neskontrolovaný automatický prepis: nepublikujte ho ako kompletný. Chyby v menách, negáciách, číslach a zmenách rečníkov môžu obrátiť význam.

Kam ho umiestniť

Umiestnite prvok za odsek, ktorý pomenúva nahrávku, vysvetľuje, prečo patrí na stránku, a uvádza, čo sa čitatelia dozvedia. Predstavte hosťa pred ukážkou; stanovte výsledok prípadovej štúdie pred podporným audio; ponechajte písomnú dokumentáciu autoritatívnu pred voliteľným rozprávaním.

Na stránke vedenej podcastom môže prehrávač nasledovať po hero sekcii, ale prepis a kľúčové tvrdenia zostávajú podstatou. Podporný úryvok umiestnite za jeho tvrdenie a pred následnú analýzu; časovo označenú ukážku ponechajte s jej pasážou prepisu.

Nadpis, zhrnutie, prehrávač, dĺžka, pripísanie, kapitoly, ovládací prvok prepisu a záložné riešenie ponechajte v jednom označenom regióne. Prepis môže nasledovať alebo používať prístupné zobrazenie, ale jeho kompletný HTML kód musí byť odoslaný pri načítaní. Nikdy ho nesmiete blokovať alebo načítať až po prehrávaní.

Vložený prehrávač nesmie stáť vedľa iného prehrávača, automaticky sa prehrávajúceho videa, znejúcej reklamy, formulára na získanie kontaktov alebo vysoko dôraznej výzvy na akciu. Nesmie rozdeľovať varovanie od jeho akcie, prerušovať očíslovaný krok ani rozdeľovať citát od jeho pripísania. Ponechajte dostatočný odstup, aby bolo jasné, že ovládacie prvky patria k audiu.

Anatómia

Popísaný screenshot musí identifikovať:

1. Názov: špecificky pomenúva epizódu alebo úryvok; neopakuje názov stránky bez pridania rozsahu.
2. Zhrnutie: v jednej alebo dvoch vetách uvádza, kto hovorí, čo je pokryté a prečo je počúvanie užitočné.
3. Prehrávač: používa natívne alebo skontrolované ovládacie prvky pre prehrávanie, pauzu, posúvanie, hlasitosť, uplynutý čas a dĺžku.
4. Dĺžka: zobrazuje sa ako text mimo ovládacieho prvku, aby bola námaha známa pred načítaním prehrávača.
5. Pripísanie a dátum: identifikujú rečníkov, vydavateľa, dátum nahrávania alebo publikovania a relevantný kontext povolenia.
6. Kapitoly: poskytujú krátke štítky a časové pečiatky pre nahrávky dlhšie ako desať minút alebo obsahujúce odlišné témy.
7. Prístup k prepisu: sprístupňuje kompletný, upravený prepis s označením rečníkov bez nutnosti prehrávania.
8. Záložné riešenie: poskytuje kanonický HTTPS odkaz na epizódu alebo súbor, keď vložený prehrávač zlyhá.
9. Informácie o sťahovaní: ak je sťahovanie povolené, uvádza formát a približnú veľkosť súboru pred požiadavkou.
10. Oznámenie o poskytovateľovi: vysvetľuje, keď externý poskytovateľ prijíma požiadavku alebo nastavuje úložisko, a to pred uskutočnením tohto spojenia, kde je potrebný súhlas.

Príklady dizajnu

Každá varianta zachováva názov, zhrnutie, dĺžku, pripísanie, kompletný prepis a záložné riešenie. Prezentácia sa môže meniť; informačná zmluva nie.

Natívny inline prehrávač — predvolený

Použite ovládacie prvky prehliadača pre schválené vlastné médiá. Toto je najmenej prekvapivá možnosť a vyhýba sa ťažkému widgetu na podcasty. Pridajte kódovania len vtedy, keď to podporujú údaje, a vracajte správny typ média a správanie rozsahu bajtov.

Karta epizódy podcastu

Použite pre skutočnú epizódu s názvom série, názvom, dátumom, stabilným číslom epizódy a kanonickým odkazom. Pridajte obálku len vtedy, keď existuje schválený asset. Akcie na odber umiestnite až za vstupný bod prepisu.

Kapitolový dlhý prehrávač

Použite nad desať minút alebo pri zmene tém. Kapitoly potrebujú popisné štítky, nie „Druhá časť.“ Každá časová pečiatka by mala posúvať prehrávač a stále identifikovať nadpis prepisu bez použitia skriptov.

Úryvok s prepisom na prvom mieste

Použite, keď krátka pasáž podporuje tvrdenie. Zobrazte jej prepis, uveďte úpravy interpunkcie alebo dĺžky a linkujte na plný kontext. Nikdy nespájajte samostatné vety tak, aby zneli súvisle bez označenia úpravy.

Poskytovateľ s bránou súhlasu

Použite, keď externý hostiteľ vyžaduje povolenie. Pomenujte poskytovateľa a dôsledok, potom ponúknite presnú akciu, napríklad „Povoliť poskytovateľa a načítať prehrávač.“ Odmietnutie ponecháva zhrnutie, prepis a kanonický odkaz použiteľné.

Parametre

„Zdroj“ znamená autorom určené miesto, z ktorého renderer získava hodnotu. Neznamená to vydavateľa audia alebo zdroj dôkazu.

Renderer musí mať na povolenom zozname poskytovateľov a typy médií, odmietať skriptovateľný alebo ľubovoľný HTML kód na vloženie a escapovať autorom napísané štítky. src identifikuje doručenie média; nikdy nenahrádza názov, zhrnutie ani prepis. Telo mapuje svoj prvý nadpis na title, prvý odsek na summary a označené sekcie Rečníci, Kapitoly a Prepis na štruktúrované polia.

Syntax a príklady kódu

Tri nižšie uvedené formy predstavujú rovnaké kanonické polia. Ich URL sú ilustračné špecifikačné hodnoty, nie assety, na ktoré táto stránka odkazuje.

Prenosná Markdown direktíva

:::audio-embed{src="https://media.example.com/episodes/migration-validation.mp3" provider=native variant=chaptered duration=PT14M6S published=2026-08-27 media-type="audio/mpeg" download=false fallback-url="https://example.com/podcast/migration-validation/"}
## Ako sme overili migráciu

Technický vedúci vysvetľuje kontroly vykonané pred a po spustení vrátane prahu pre rollback.

Rečníci: Maya Chen, technická vedúca; Leon Ward, moderátor

Kapitoly:
- 00:00 — Východiská a kritériá spustenia
- 04:12 — Presmerovanie a kanonické kontroly
- 09:40 — Prah pre rollback

Prepis:
### Východiská a kritériá spustenia
**Leon Ward:** Čo ste zaznamenali pred spustením?
**Maya Chen:** Exportovali sme kanonické URL, stavové kódy a baseline organických vstupných stránok.
:::

Hugo shortcode

Hugo notácia používa len pomenované parametre. Dokumentuje zamýšľaný adaptér a nevyvoláva ani netvrdí, že lokálny shortcode už existuje.

{{< audio-embed src="https://media.example.com/episodes/migration-validation.mp3" provider="native" variant="chaptered" duration="PT14M6S" published="2026-08-27" mediaType="audio/mpeg" download="false" fallbackUrl="https://example.com/podcast/migration-validation/" >}}
## Ako sme overili migráciu

Technický vedúci vysvetľuje kontroly vykonané pred a po spustení vrátane prahu pre rollback.

Rečníci: Maya Chen, technická vedúca; Leon Ward, moderátor

Kapitoly:
- 00:00 — Východiská a kritériá spustenia
- 04:12 — Presmerovanie a kanonické kontroly
- 09:40 — Prah pre rollback

Prepis:
### Východiská a kritériá spustenia
**Leon Ward:** Čo ste zaznamenali pred spustením?
**Maya Chen:** Exportovali sme kanonické URL, stavové kódy a baseline organických vstupných stránok.
{{< /audio-embed >}}

Adaptér by mal vykresliť <audio controls preload="metadata"> pre natívne médiá, pridať <source type="audio/mpeg"> a zahrnúť záložný text a normálny odkaz vnútri elementu audio. Externý poskytovateľ by sa mal načítať len podľa deklarovaného správania so súhlasom a nesmie prijímať ľubovoľné atribúty iframe dodané autorom.

WordPress blok

<!-- wp:amicited/audio-embed {"src":"https://media.example.com/episodes/migration-validation.mp3","provider":"native","variant":"chaptered","duration":"PT14M6S","published":"2026-08-27","mediaType":"audio/mpeg","download":false,"fallbackUrl":"https://example.com/podcast/migration-validation/"} -->
<h2>Ako sme overili migráciu</h2>
<p>Technický vedúci vysvetľuje kontroly vykonané pred a po spustení vrátane prahu pre rollback.</p>
<p data-speakers>Maya Chen, technická vedúca; Leon Ward, moderátor</p>
<ol data-chapters><li><time datetime="PT0S">00:00</time> — Východiská a kritériá spustenia</li><li><time datetime="PT4M12S">04:12</time> — Presmerovanie a kanonické kontroly</li><li><time datetime="PT9M40S">09:40</time> — Prah pre rollback</li></ol>
<section data-transcript><h3>Východiská a kritériá spustenia</h3><p><strong>Leon Ward:</strong> Čo ste zaznamenali pred spustením?</p><p><strong>Maya Chen:</strong> Exportovali sme kanonické URL, stavové kódy a baseline organických vstupných stránok.</p></section>
<!-- /wp:amicited/audio-embed -->

Uložené atribúty WordPress a serverom vykreslený výstup musia zachovať rovnakú dĺžku, rečníkov, kapitoly a prepis. Editor môže zobraziť náhľad waveformu, ale waveform nie je náhradou za označený ovládací prvok posúvania alebo textovú navigáciu.

Príklady

Dobrý: nahrávka, ktorá zostáva užitočná aj bez zvuku

Prečo tím nastavil 30-minútové okno pre rollback
Priya Shah, manažérka vydania, vysvetľuje pozorovateľné podmienky, ktoré by zastavili migráciu. Dĺžka: 2:18.
Kapitoly: 00:00 — Vlastník rozhodnutia · 00:42 — Podmienky zastavenia · 01:31 — Poradie obnovy
Ukážka prepisu: Priya Shah: „Hodiny samy osebe neboli spúšťačom. Vrátili by sme sa späť, ak by chyby pri pokladni prekročili dohodnutý prah a nové vydanie bolo potvrdenou príčinou.“
Nahraté 21. augusta 2026 · Plný prepis nasleduje

Toto je dobré, pretože názov uvádza rozhodnutie, rola rečníka stanovuje relevantnosť, kapitoly robia krátku ukážku navigovateľnou a prepis zachováva presnú kvalifikáciu: uplynutý čas sám osebe nebol spúšťačom. Čitateľ aj crawler môžu porozumieť dôkazu bez načítania média. Prvok nevyrába štatistiku ani neoddeľuje citát od kontextu.

Zlý: nepriehľadný propagačný prehrávač

Počúvajte teraz!
▶ Epizóda 47
Tajomstvo, ktoré všetko mení.

Toto je zlé, pretože názov nesľubuje nič overiteľné, chýba rečník a téma a „Epizóda 47“ má význam len pre existujúceho predplatiteľa. Nie je uvedená dĺžka, prepis, dátum, pripísanie, navigácia po kapitolách ani cesta zlyhania. Ak je externý widget zablokovaný, stránka stráca celú svoju podstatu. Prehnaný teaser tiež skrýva, či je nahrávka dôkaz, inštrukcia, názor alebo reklama.

Schéma markup a prístupnosť

Štruktúrované údaje opisujú médiá; nerobia audio indexovateľným. Použite AudioObject len pre prehrateľné audio s presným name, description, URL, duration, uploadDate a podrobnosťami o kódovaní, ak sú známe. Použite PodcastEpisode len pre skutočnú epizódu a prepojte ju s jej udržiavanou sériou. Úryvok rozhovoru nie je epizóda. Obklopujúca stránka si zachováva svoj vhodný primárny typ.

Nemenite názor rečníka na hodnotenie recenzie, výpoveď zákazníka na neoverený výsledok ani dátum publikovania na dátum nahrávania. Pripojte výskumné referencie v prepise a použite blok zdrojov skôr než očakávať, že metadáta média vytvoria dôveryhodnosť.

Prístupnosť začína ekvivalentným obsahom. Prepis musí zahŕňať všetky hovorené slová, ktoré nesú význam, identifikovať rečníkov vždy, keď zmena hlasu nie je v texte zrejmá, a opisovať dôležité nehovorené zvuky, ako napríklad [alarm] alebo [dlhá pauza], keď ovplyvňujú interpretáciu. Upravte automatický prepis podľa nahrávky. Zachovajte zmysluplné falošné začiatky alebo neistotu, ale odstráňte výplňové slová len v rámci zverejnenej redakčnej politiky, ktorá nemení význam.

Použite natívne ovládacie prvky tam, kde spĺňajú požiadavku podporovaného prehliadača, alebo zaistite, aby každý vlastný ovládací prvok bol ovládateľný klávesnicou, mal viditeľné zaostrenie, bol označený a zverejňoval svoj názov, rolu, hodnotu a stav. Používatelia potrebujú prehrávanie a pauzu, posúvanie, uplynutý a celkový čas, hlasitosť alebo stlmenie tam, kde je to vhodné, a spôsob, ako okamžite zastaviť audio. Ovládací prvok rýchlosti prehrávania sa odporúča pre reč dlhšiu ako päť minút. Nespoliehajte sa len na waveform: mnohým používateľom nekomunikuje ani polohu, ani význam kapitoly.

Nikdy nespúšťajte redakčné audio automaticky. Nekradnite zaostrenie, keď sa prehrávač inicializuje, a zachovajte zaostrenie, ak sa fasáda so súhlasom stane prehrávačom. Ohlasujte chyby bez opakovaného ohlasovania času prehrávania. Externé rámce potrebujú popisné názvy, rezervované rozmery a normálny záložný odkaz. Prepis, zhrnutie a kapitoly musia fungovať pri 200% priblížení, s klávesnicovou navigáciou a bez JavaScriptu alebo úložiska tretej strany.

Pravidlá písania

Napíšte okolitý text tak, aby sa čitateľ mohol rozhodnúť, či chce počúvať, a aby získal podstatu nahrávky bez počúvania.

• Názov udržujte na 4–14 slovách a nech identifikuje tému alebo rozhodnutie, nie iba „Podcast“ alebo „Počúvajte teraz.“
• Zhrnutie udržujte na 20–50 slovách v najviac dvoch vetách. Uveďte rečníka alebo formát, tému a hodnotu počúvania.
• Dĺžku zobrazte mimo prehrávača vo formáte m:ss pod jednu hodinu alebo h:mm:ss od jednej hodiny vyššie. Strojovú hodnotu ukladajte ako ISO 8601.
• Uveďte 1–12 rečníkov alebo použite stabilné označenia rolí ako „Moderátor“ a „Volajúci“ vtedy, keď súkromie alebo zdroj bráni zverejneniu mena.
• Pridajte 2–20 kapitol, keď nahrávka dlhšia ako desať minút mení tému. Štítky udržujte na 3–10 slovách a prvú kapitolu umiestnite na 00:00.
• Publikujte kompletný prepis pre redakčnú reč. Zhrnutie, vybrané citácie, súbor s titulkami alebo text generovaný poskytovateľom dostupný až po prehrávaní sa nekvalifikuje.
• Používajte krátke odseky prepisu, tučné označenie rečníkov, popisné nadpisy pre zmeny tém a časové pečiatky aspoň na každej hranici kapitoly.
• Overte mená, značky, URL, čísla, jednotky, negácie a odbornú terminológiu podľa nahrávky a zdrojového materiálu.
• Uveďte, či je úryvok skrátený alebo preskupený. Označte vynechania; nikdy nespájajte slová do vety, ktorú rečník nepovedal.
• Použite neutrálny, špecifický úvod. Vyhnite sa medzerám zvedavosti, falošnej naliehavosti a tvrdeniam, že epizóda je „nevyhnutná“ alebo „prelomová.“
• Nikdy neumiestňujte reklamy medzi kapitoly, e-mailovú bránu, nútený tok účtu, skryté sledovanie, príznak automatického prehrávania, surový HTML iframe alebo nesúvisiace tlačidlá predplatného do jadra prvku.
• Nepublikujte súkromný rozhovor, nelicencovanú hudbu, dôverné údaje zákazníka ani nahrávku rečníka bez zdokumentovaného povolenia a požadovanej kontroly.

Typy príspevkov, ktoré ho používajú

Táto tabuľka je riadená registrovaným zoznamom postTypes v frontmatter.

Kontrolný zoznam QA

• Počutie nahrávky pridáva dôkazy, kontext, výslovnosť, emócie alebo pohodlie pri počúvaní, ktoré odôvodňujú audio prvok.
• Názov, zhrnutie, dĺžka, rečníci, dátum a vzťah k stránke sú jasné pred prehrávaním.
• Kompletný, upravený prepis je prítomný v počiatočnom HTML vygenerovanom na serveri a nevyžaduje prehrávanie, súhlas, prihlásenie ani JavaScript.
• Prepis zodpovedá konečnému publikovanému zneniu a správne zachováva mená, čísla, negácie, neistotu a zmeny rečníkov.
• Úryvky zverejňujú vynechania alebo preskupenie a nespájajú samostatné výroky do zavádzajúceho citátu.
• Nahrávky nad desať minút s viacerými témami majú popisné, presné kapitoly mapované na nadpisy prepisu.
• Prehrávanie, pauza, zastavenie, posúvanie, čas, hlasitosť, zaostrenie a rýchlosť prehrávania fungujú s klávesnicou a asistenčnou technológiou podľa potreby.
• Audio sa nikdy nespúšťa automaticky a aktivácia alebo nahradenie fasády so súhlasom nestráca zaostrenie.
• Zablokovaný poskytovateľ alebo zlyhaná požiadavka na médiá ponecháva zhrnutie, prepis, pripísanie, dĺžku a kanonický záložný odkaz použiteľné.
• Požiadavky externého poskytovateľa sa riadia politikou súhlasu stránky a zverejnenie pomenúva poskytovateľa pred odoslaním údajov tam, kde sa to vyžaduje.
• Natívne zdroje vracajú deklarovaný typ média, podporujú očakávané správanie posúvania a nevynucujú sťahovanie, pokiaľ si ho používateľ nevyberie.
• Odkazy na stiahnutie uvádzajú formát a približnú veľkosť; neschválené alebo neexistujúce obrázky obálok nie sú odkazované.
• Údaje AudioObject alebo PodcastEpisode, ak sú prítomné, opisujú presnú prehrateľnú nahrávku a zhodujú sa s viditeľnými faktami.
• Prvok nemá vedľa seba konkurenčný prehrávač, znejúcu reklamu, formulár na získanie kontaktov ani vysoko dôraznú výzvu na akciu.
• Mobilné rozloženie nepretečie; ovládacie prvky zostávajú použiteľné pri 200% priblížení a s veľkým textom.
• Povolenie na publikovanie, licencovanie hudby, kontrola súkromia a faktická kontrola sú zaznamenané tam, kde ich obsah vyžaduje.

FAQ

Vyššie uvedené otázky sa týkajú úplnosti prepisu, automatického prehrávania, správania pri zverejňovaní, výberu schémy a zlyhania poskytovateľa. Ich odpovede sú registrované v frontmatter, aby ich šablóna Akadémie mohla konzistentne vykresliť, zatiaľ čo toto telo zostáva špecifikáciou implementácie.