Audio Player rozhraní s příkladovým názvem.
Audio Player rozhraní s příkladovým názvem.
← Všechny nativní průvodce

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Přidejte čistý audio přehrávač do lekcí, hlasových zpráv nebo záznamů produktů. Umožněte posluchačům poslouchat, měnit rychlost a pokračovat od uložené pozice.

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

Dokumentace přezkoumána 6 listopad 2026

Praktické příklady

Hlasové poznámky v rámci konverzace podpory

Prostý odkaz na soubor odvede uživatele od konverzace a ztíží přezkoumání dlouhých odpovědí.

`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.

Umístěte přehrávač do detailu vybrané zprávy. Umožněte uživateli Play/Pause, Seek na užitečný bod a Set speed. Navážete `is_active` na otevřenou konverzaci.

Použijte `is_playing`, `current_time` a `duration` k zobrazení postupu. Uchovejte ID Message ve své aplikaci, aby pozdní událost nemohla aktualizovat jinou konverzaci.

Na `player_error` zobrazte `error_code` a nabídněte Reload source; zachovejte zprávu a nikdy ji po chybě neoznačujte jako poslechnutou.

Pouze přehrávání. Vaše aplikace ukládá posluchačský postup.

Obnovte jazykovou lekci na uložené pozici

Učící se potřebují přehrát obtížný úsek místo restartování celé lekce.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; poslední pozice patří tomuto učícímu se a lekci ve vaší databázi.

Po `ready` pro aktuální lekci, Seek na uložené sekundy a čekejte, až uživatel Play. Pro pomalejší poslech použijte Set speed. Uložte postup pomocí vlastního pracovního postupu aplikace.

Přečtěte `current_time` a `duration`. Na `playback_ended` může vaše aplikace zaznamenat milník poslechu pro aktuální Lesson.

Pokud se zdroj změnil, zahodte starou pozici, dokud není lekce načtena. Nepovažujte dokončení poslechu za důkaz, že učící se pochopil nebo složil test.

Pouze přehrávání. Vaše aplikace ukládá posluchačský postup.

Prohlédněte si audio přílohu s časově označenými komentáři

Editoři nebo školitelé potřebují přejít z komentáře na relevantní okamžik v nahrávce.

`source_url = Selected Review’s recording URL`; každý komentář vlastněný aplikací ukládá vlastní hodnotu sekund; volitelný `waveform_peaks_json` obsahuje skutečné špičky pro stejné nahrávání.

Klikněte na komentář → Seek na jeho sekundy → Play. Při změně zdroje nahraďte nebo vymažte špičky a znovu připojte vybranou recenzi.

Zobrazte `current_time` vedle editoru komentáře. `waveform_available` informuje vaše UI, zda jsou k dispozici skutečné dodané špičky.

Omezte nebo odmítněte zastaralé časové značky vůči aktuální délce ve vaší aplikaci. Když neexistují skutečné špičky, zobrazte běžný ovladač postupu místo vymyšlené audio analýzy.

Pouze přehrávání. Vaše aplikace ukládá posluchačský postup.

Co funguje nyní

Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.

Vytvořte pracovní postup

Použijte níže dostupné beta akce a otestujte výsledek na svých cílových zařízeních.

Tyto příklady používají záznamy aplikace, jako jsou Lesson, Message a Order. Nahraďte je vlastními typy dat a názvy prvků. Příkladové adresy médií je třeba nahradit vlastními soubory.

  1. Přidejte audio prvek. Nastavte source_url = Selected Message's audio_url, title = Selected Message's sender_label a subtitle = Selected Message's date_label.

  2. Pokud máte skutečná data vlnové formy pro tuto nahrávku, předávejte je v waveform_peaks_json. Jinak nechte prázdné.

  3. Když nastane událost ready, použijte Seek s uloženým počtem sekund, pokud je potřeba. Nechte uživatele stisknout Play. Pro tlačítka přehrávače použijte Pause, Seek a Set speed.

  4. Zobrazte current_time a duration. Při playback_ended uložte posluchačský postup pro vybranou zprávu nebo lekci. Nastavte is_active podle toho, zda je tento pohled otevřen.

Diagram pracovního postupu — ne snímek obrazovky aplikace

Nastavte jednou

Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera Audio Player Native, zkopírujte jeho klíč, poté otevřete Bubble → Plugins → Xodera Audio Player Native a vložte jej do licensing_api_key. Uložte jednou; poté použijte akce níže. Každý plugin v každém projektu má svůj vlastní klíč.

Použijte přímou adresu audio souboru, kterou aplikace může otevřít. Přehrávání audia nevyžaduje přístup k mikrofonu ani kameře.

Nastavte jednou
  1. Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins.
  2. Vyberte tento plugin a zkopírujte jeho projektový klíč.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Přidejte prvek, vyberte svá data aplikace a vytvořte níže uvedený pracovní postup.
  5. In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
Instalace a předplatné

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Uložte výsledek ve své aplikaci

Příklad ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Ukládejte, když uživatel pozastaví nebo opustí lekci, místo při každé aktualizaci obrazovky.

Selhání, zrušení a obnovení

Na player_error zobrazte error_code a nabídněte Reload source. Uchovejte záznam zprávy nebo lekce. Když je vybráno jiné nahrávání, načtěte jeho vlastní uloženou pozici. Návrat do zobrazení automaticky nepřehraje.

Možnosti a limity

Rychlosti přehrávání: 1, 1.5 a 2. Hlasitost: 0–1. Data vlnové formy: 2–2048 hodnoty mezi 0 a 1. Podporované audio formáty závisí na zařízení. Přehrávač nenahrává, nepřepisuje ani trvale neukládá audio pro offline použití. Přehrávání na pozadí a na zamykací obrazovce není zaručeno.

Nastavení, akce a výsledky

Použijte tyto názvy v Bubble. Plánované funkce jsou označeny zvlášť.

Dostupná beta nastavení

Nastavení prvku

source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · text

Stavy

player_status · textis_playing · yes_nois_loaded · yes_nois_buffering · yes_nocurrent_time · numberduration · numberprogress · numberplayback_rate · numbervolume · numberis_looping · yes_nowaveform_available · yes_nowaveform_status · texterror_code · text

Události

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Akce a jejich vstupy

PlayPauseToggleStopSeekSet speedSet volumeReload source
Nastavení prvku · 11
source_urltext · Výchozí: ""
Ukázková hodnotahttps://bestplugins.online/native-samples/lesson.mp3
Příklad Bubble výrazuSelected Message's audio_url
Adresa vybraného audio, video nebo obrázkového souboru. Použijte typ souboru, který tento plugin podporuje.
waveform_peaks_jsontext · Výchozí: ""
Ukázková hodnota[0.1,0.4,0.2,0.7]
Příklad Bubble výrazuSelected Message's waveform_peaks_json
Skutečné normalizované hodnoty amplitudy pro toto nahrávání; nechte prázdné, pokud nejsou k dispozici.
titletext · Výchozí: ""
Ukázková hodnotaLesson 4 — review
Příklad Bubble výrazuSelected Lesson's name
Viditelný text aplikace; prázdné použije vestavěnou lokalizovanou verzi, kde je podporována. Žádné přihlašovací údaje.
subtitletext · Výchozí: ""
Ukázková hodnotaTeacher · today
Příklad Bubble výrazuSelected Message's sender_label
Viditelný text aplikace; prázdné použije vestavěnou lokalizovanou verzi, kde je podporována. Žádné přihlašovací údaje.
playback_ratenumber · Výchozí: 1
Ukázková hodnota1.5
Příklad Bubble výrazuCurrent User's listening_speed
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
volumenumber · Výchozí: 1
Ukázková hodnota0.8
Příklad Bubble výrazuVolume Slider's value
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
loopyes_no · Výchozí: false
Ukázková hodnotano
Příklad Bubble výrazuSelected Lesson's repeat_enabled
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
is_activeyes_no · Výchozí: true
Ukázková hodnotayes
Příklad Bubble výrazuGuideHost's view_is_active (your yes/no custom state)
Nastavte ano, dokud je tento pohled otevřený. Nastavte ne při odchodu, aby se přehrávání nebo aktuální práce mohly zastavit.
disabledyes_no · Výchozí: false
Ukázková hodnotano
Příklad Bubble výrazuGuideHost's is_busy (your yes/no custom state)
Deaktivujte prvek, když je aplikace zaneprázdněná nebo je tato akce nedostupná.
ui_text_jsontext · Výchozí: ""
Ukázková hodnota{}
Příklad Bubble výrazuApp Settings' player_labels_json (supported keys only)
Volitelný JSON s podporovanými popisky tlačítek. Nechte prázdné pro použití vestavěného textu.
languagetext · Výchozí: "auto"
Ukázková hodnotauk
Příklad Bubble výrazuCurrent User's preferred_language
Nastavte language=auto tak, aby sledoval podporované zařízení nebo jazyk prohlížeče. Zadejte podporovaný kód jazyka pro jeho explicitní výběr.
Akce a jejich vstupy · 8
Play

Žádné parametry akce

Pause

Žádné parametry akce

Toggle

Žádné parametry akce

Stop

Žádné parametry akce

Seek
secondsnumber · Výchozí: —
Ukázková hodnota12
Příklad Bubble výrazuSelected Comment's seconds
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Set speed
ratenumber · Výchozí: —
Ukázková hodnota1.5
Příklad Bubble výrazuSpeed Dropdown's value
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Set volume
volumenumber · Výchozí: —
Ukázková hodnota0.8
Příklad Bubble výrazuVolume Slider's value
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Reload source

Žádné parametry akce

Stavy a události

Stavy

player_status · text

Aktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.

is_playing · yes_no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

is_loaded · yes_no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

is_buffering · yes_no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

current_time · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

duration · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

progress · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

playback_rate · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

volume · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

is_looping · yes_no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

waveform_available · yes_no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

waveform_status · text

Aktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.

error_code · text

Informace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.

Události

ready

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

playback_started

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

playback_paused

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

playback_ended

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

seek_completed

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

rate_changed

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

player_error

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

Otázky, které vývojáři kladou

Vytváří to vlnový průběh?

Ne. Poskytněte skutečné normalizované špičky pro tento zdroj; běžný postup funguje i bez nich.

Jak funguje předplatné?

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Související průvodci

Pro pomoc nám sdělte, který plugin a zařízení používáte, jakou akci jste zkusili a co se stalo. Použijte příklad bez osobních údajů. Nikdy nesdílejte svůj klíč ani soukromé soubory.