Audio Player felület egy példacímmel.
Audio Player felület egy példacímmel.
← Minden natív útmutató

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.

  1. 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.

  2. Ha rendelkezik valós hullámforma adatokkal ehhez a felvételhez, adja meg a waveform_peaks_json-ben. Ellenkező esetben hagyja üresen.

  3. 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.

  4. 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.

Munkafolyamat diagram — nem alkalmazás képernyőkép

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
  1. Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
  2. Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
  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.
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 · text

Események

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Műveletek és azok bemenetei

PlayPauseToggleStopSeekSet speedSet volumeReload source
Elem beállítások · 11
source_urltext · Alapértelmezett: ""
Példaértékhttps://bestplugins.online/native-samples/lesson.mp3
Példa Bubble kifejezésSelected 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ésSelected 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ékLesson 4 — review
Példa Bubble kifejezésSelected 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ékTeacher · today
Példa Bubble kifejezésSelected 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ék1.5
Példa Bubble kifejezésCurrent 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ék0.8
Példa Bubble kifejezésVolume 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ékno
Példa Bubble kifejezésSelected 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ékyes
Példa Bubble kifejezésGuideHost'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ékno
Példa Bubble kifejezésGuideHost'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ésApp 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ékuk
Példa Bubble kifejezésCurrent 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ék12
Példa Bubble kifejezésSelected 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ék1.5
Példa Bubble kifejezésSpeed 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ék0.8
Példa Bubble kifejezésVolume 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 · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

is_playing · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

is_loaded · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

is_buffering · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

current_time · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

duration · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

progress · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

playback_rate · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

volume · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

is_looping · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

waveform_available · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

waveform_status · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

error_code · text

Hibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.

Események

ready

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

playback_started

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

playback_paused

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

playback_ended

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

seek_completed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

rate_changed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

player_error

Amikor 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.