
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.
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.
Pokud máte skutečná data vlnové formy pro tuto nahrávku, předávejte je v waveform_peaks_json. Jinak nechte prázdné.
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.
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.
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
- Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins.
- Vyberte tento plugin a zkopírujte jeho projektový klíč.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Přidejte prvek, vyberte svá data aplikace a vytvořte níže uvedený pracovní postup.
- 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 · textStavy
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 · textUdálosti
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorAkce a jejich vstupy
PlayPauseToggleStopSeekSet speedSet volumeReload sourceNastavení prvku · 11
source_urltext · Výchozí: ""- Ukázková hodnota
https://bestplugins.online/native-samples/lesson.mp3 - Příklad Bubble výrazu
Selected 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ýrazu
Selected 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á hodnota
Lesson 4 — review - Příklad Bubble výrazu
Selected 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á hodnota
Teacher · today - Příklad Bubble výrazu
Selected 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á hodnota
1.5 - Příklad Bubble výrazu
Current 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á hodnota
0.8 - Příklad Bubble výrazu
Volume 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á hodnota
no - Příklad Bubble výrazu
Selected 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á hodnota
yes - Příklad Bubble výrazu
GuideHost'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á hodnota
no - Příklad Bubble výrazu
GuideHost'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ýrazu
App 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á hodnota
uk - Příklad Bubble výrazu
Current 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á hodnota
12 - Příklad Bubble výrazu
Selected 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á hodnota
1.5 - Příklad Bubble výrazu
Speed 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á hodnota
0.8 - Příklad Bubble výrazu
Volume 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 · textAktuá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_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
is_loaded · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
is_buffering · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
current_time · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
duration · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
progress · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
playback_rate · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
volume · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
is_looping · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
waveform_available · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
waveform_status · textAktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.
error_code · textInformace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.
Události
readyKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
playback_startedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
playback_pausedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
playback_endedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
seek_completedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
rate_changedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
player_errorKdyž 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.