
Xodera Plugins · Bubble Native
Xodera Audio Player Native
Adjon hozzá egy tiszta hanglejátszót a leckékhez, hangüzenetekhez vagy termékrekordokhoz. Engedje a felhasználóknak a hallgatást, a sebesség módosítását és a mentett helyről való folytatást.
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.
Dokumentáció felülvizsgált 6 november 2026
Gyakorlati példák
Hangjegyzetek egy támogatási beszélgetésben
Egy egyszerű fájlhivatkozás elirányítja a felhasználókat a beszélgetésből, és nehézzé teszi a hosszú válaszok áttekintését.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
Helyezze a lejátszót a kiválasztott üzenet részleteibe. Engedje, hogy a felhasználó Play/Pause, Seek egy hasznos pontig, és Set speed. Kapcsolja össze a `is_active`-et a nyitott beszélgetéssel.
Használja a `is_playing`, `current_time` és `duration` értékeket az előrehaladás megjelenítéséhez. Tartsa meg a Message azonosítót az alkalmazásában, hogy egy késői esemény ne frissíthessen más beszélgetést.
A `player_error` esetén jelenítse meg a `error_code`-et, és kínálja fel a Reload source-et; őrizze meg az üzenetet, és hibát követően soha ne jelölje meg hallgatottként.
Csak lejátszás. Az alkalmazása menti a hallgatási előrehaladást.
Folytassa a nyelvleckét a mentett pozíción
A tanulóknak újra kell játszaniuk egy nehéz részletet a teljes lecke újraindítása helyett.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; az utolsó pozíció az adott tanulóhoz és leckéhez tartozik az adatbázisában.
A jelenlegi lecke `ready` után, Seek a mentett másodpercekig, és várja, hogy a felhasználó Play. Használja a Set speed-et lassabb hallgatáshoz. Mentse az előrehaladást saját alkalmazásfolyamával.
Olvassa a `current_time`-et és a `duration`-et. A `playback_ended` esetén az alkalmazása rögzíthet egy hallgatási mérföldkövet a jelenlegi Lesson-hez.
Ha a forrás megváltozott, dobja el a régi pozíciót, amíg a lecke be nem töltődik. Ne tekintse a hallgatás befejezését bizonyítéknak arra, hogy a tanuló megértette vagy letett egy tesztet.
Csak lejátszás. Az alkalmazása menti a hallgatási előrehaladást.
Egy hangmelléklet áttekintése időbélyeggel ellátott megjegyzésekkel
A szerkesztőknek vagy oktatóknak a megjegyzésből a felvétel megfelelő pillanatára kell ugraniuk.
`source_url = Selected Review’s recording URL`; minden alkalmazás által kezelt megjegyzés saját másodpercértéket tárol; opcionális `waveform_peaks_json` valós csúcsokat tartalmaz ugyanahhoz a felvételhez.
Kattintson egy megjegyzésre → Seek a másodperceihez → Play. Forrásváltozás esetén cserélje vagy törölje a csúcsokat, és kössön újra a kiválasztott áttekintéshez.
Jelenítse meg a `current_time`-et a megjegyzésszerkesztő felület mellett. A `waveform_available` jelzi a felhasználói felületnek, hogy a ténylegesen biztosított csúcsok elérhetők-e.
Korlátozza vagy utasítsa el a régi időbélyegeket az alkalmazás aktuális időtartamával szemben. Ha nincs valós csúcs, jelenítse meg a szokásos folyamatjelzőt a kitalált hanganalízis helyett.
Csak lejátszás. Az alkalmazása menti a hallgatási előrehaladást.
Mi működik most
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.
A munkafolyamat felépítése
Használja az alább elérhető béta műveleteket, és tesztelje az eredményt a céleszközein.
Ezek a példák olyan alkalmazásrekordokat használnak, mint a Lesson, Message és Order. Cserélje ki őket saját adat típusokra és elemnevekre. A példaként megadott média címeket saját fájljaival kell helyettesíteni.
Adja hozzá a hang elemet. Állítsa be a source_url = Selected Message's audio_url-t, a title = Selected Message's sender_label-t és a subtitle = Selected Message's date_label-t.
Ha rendelkezik valós hullámforma adatokkal ehhez a felvételhez, adja meg a waveform_peaks_json-ben. Ellenkező esetben hagyja üresen.
Amikor a ready esemény bekövetkezik, használja a Seek-t a mentett másodpercek számával, ha szükséges. Engedje a felhasználónak, hogy megnyomja a Play-t. Használja a Pause, Seek és Set speed-t a lejátszó gombokhoz.
Jelenítse meg a current_time-t és a duration-t. A playback_ended esetén mentse a hallgatási előrehaladást a kiválasztott üzenethez vagy leckéhez. Állítsa be a is_active-t, hogy a nézet nyitva van-e.
Egyszeri beállítás
Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt. Válassza ki a Xodera Audio Player Native-t, másolja a kulcsát, majd nyissa meg a Bubble → Plugins → Xodera Audio Player Native-t, és illessze be a licensing_api_key-be. Mentse el egyszer; ezután használja az alábbi műveleteket. Minden bővítmény minden projektben saját kulccsal rendelkezik.
Használjon közvetlen hangfájl címet, amelyet az alkalmazás megnyithat. A hang lejátszásához nem szükséges mikrofon vagy kamera hozzáférés.
Egyszeri beállítás
- Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
- Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
- 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.
Telepítés és előfizetés
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.
Eredmény mentése az alkalmazásodba
Példa ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Mentse, amikor a felhasználó szünetelteti vagy elhagyja a leckét, ahelyett, hogy minden képernyőfrissítésnél mentene.
Hiba, megszakítás és helyreállítás
A player_error esetén jelenítse meg a error_code-t és kínálja a Reload source-t. Tartsa meg az üzenet vagy lecke rekordot. Ha egy másik felvétel van kiválasztva, töltse be annak saját mentett pozícióját. A nézethez való visszatérés nem indítja el automatikusan a lejátszást.
Képességek és korlátok
Lejátszási sebességek: 1, 1.5 és 2. Hangerő: 0–1. Hullámforma adatok: 2–2048 értékek 0 és 1 között. A támogatott hangformátumok az eszköztől függenek. A lejátszó nem rögzít, nem transzkribál és nem ment tartósan hangot offline használatra. A háttér- és zárolási képernyőn történő lejátszás nem garantált.
Beállítások, műveletek és eredmények
Használja ezeket a neveket a Bubble-ben. A tervezett funkciók külön vannak jelölve.
Elérhető béta beállítások
Elem beállítások
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textÁllapotok
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 · textEsemények
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorMűveletek és azok bemenetei
PlayPauseToggleStopSeekSet speedSet volumeReload sourceElem beállítások · 11
source_urltext · Alapértelmezett: ""- Példaérték
https://bestplugins.online/native-samples/lesson.mp3 - Példa Bubble kifejezés
Selected Message's audio_url - Hivatkozás a kiválasztott hang-, videó- vagy képfájlra. Használjon olyan fájltípust, amelyet a bővítmény támogat.
waveform_peaks_jsontext · Alapértelmezett: ""- Példaérték
[0.1,0.4,0.2,0.7] - Példa Bubble kifejezés
Selected Message's waveform_peaks_json - Valódi normalizált amplitúdóértékek ehhez a felvételhez; hagyja üresen, ha nem érhető el.
titletext · Alapértelmezett: ""- Példaérték
Lesson 4 — review - Példa Bubble kifejezés
Selected Lesson's name - Látható alkalmazás szöveg; üres esetén a beépített lokalizált szöveg kerül felhasználásra, ahol támogatott. Nincsenek hitelesítő adatok.
subtitletext · Alapértelmezett: ""- Példaérték
Teacher · today - Példa Bubble kifejezés
Selected Message's sender_label - Látható alkalmazás szöveg; üres esetén a beépített lokalizált szöveg kerül felhasználásra, ahol támogatott. Nincsenek hitelesítő adatok.
playback_ratenumber · Alapértelmezett: 1- Példaérték
1.5 - Példa Bubble kifejezés
Current User's listening_speed - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
volumenumber · Alapértelmezett: 1- Példaérték
0.8 - Példa Bubble kifejezés
Volume Slider's value - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
loopyes_no · Alapértelmezett: false- Példaérték
no - Példa Bubble kifejezés
Selected Lesson's repeat_enabled - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
is_activeyes_no · Alapértelmezett: true- Példaérték
yes - Példa Bubble kifejezés
GuideHost's view_is_active (your yes/no custom state) - Állítsa igent, amíg ez a nézet nyitva van. Állítsa nemet a kilépéskor, hogy a lejátszás vagy a jelenlegi munka leállhasson.
disabledyes_no · Alapértelmezett: false- Példaérték
no - Példa Bubble kifejezés
GuideHost's is_busy (your yes/no custom state) - Tiltja le az elemet, amíg az alkalmazás foglalt vagy a művelet nem érhető el.
ui_text_jsontext · Alapértelmezett: ""- Példaérték
{} - Példa Bubble kifejezés
App Settings' player_labels_json (supported keys only) - Választható JSON a támogatott gombcímkékkel. Hagyja üresen a beépített szöveg használatához.
languagetext · Alapértelmezett: "auto"- Példaérték
uk - Példa Bubble kifejezés
Current User's preferred_language - Állítsa be a language=auto-t, hogy egy támogatott eszköz vagy böngésző nyelvét kövesse. Adjon meg egy támogatott nyelvkódot a kifejezett kiválasztáshoz.
Műveletek és azok bemenetei · 8
Play
Nincsenek műveletparaméterek
Pause
Nincsenek műveletparaméterek
Toggle
Nincsenek műveletparaméterek
Stop
Nincsenek műveletparaméterek
Seek
secondsnumber · Alapértelmezett: —- Példaérték
12 - Példa Bubble kifejezés
Selected Comment's seconds - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Set speed
ratenumber · Alapértelmezett: —- Példaérték
1.5 - Példa Bubble kifejezés
Speed Dropdown's value - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Set volume
volumenumber · Alapértelmezett: —- Példaérték
0.8 - Példa Bubble kifejezés
Volume Slider's value - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Reload source
Nincsenek műveletparaméterek
Állapotok és események
Állapotok
player_status · textA művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.
is_playing · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
is_loaded · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
is_buffering · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
current_time · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
duration · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
progress · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
playback_rate · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
volume · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
is_looping · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
waveform_available · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
waveform_status · textA művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.
error_code · textHibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.
Események
readyAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
playback_startedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
playback_pausedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
playback_endedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
seek_completedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
rate_changedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
player_errorAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
Fejlesztők által feltett kérdések
Létrehozza a hullámformát?
Nem. Adjon meg valós normalizált csúcsokat ehhez a forráshoz; a szokásos előrehaladás ezek nélkül is működik.
Hogyan működik az előfizetés?
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.
Kapcsolódó útmutatók
Segítségért mondja el, melyik plugint és eszközt használja, milyen műveletet próbált és mi történt. Használjon személyes adatokat nem tartalmazó példát. Soha ne ossza meg a kulcsát vagy privát fájljait.