Audio Player arayüzü örnek bir başlıkla.

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Derslere, sesli mesajlara veya ürün kayıtlarına net bir ses oynatıcı ekleyin. Kullanıcıların dinlemesine, hızı değiştirmesine ve kaydedilmiş konumlarından devam etmesine izin verin.

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.

İş akışını oluşturun ↓Eklenti ayarları ↗Native Lab

6 belgeleri November 2026 incelendi.

Pratik örnekler

Destek konuşması içinde sesli notlar

Düz bir dosya bağlantısı kullanıcıları konuşmadan uzaklaştırır ve uzun yanıtların incelenmesini zorlaştırır.

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

Oyuncuyu seçili mesaj detayına yerleştirin. Kullanıcının Play/Pause, Seek yapmasına ve Set speed yapmasına izin verin. `is_active`'i açık konuşmaya bağlayın.

İlerlemeyi göstermek için `is_playing`, `current_time` ve `duration` kullanın. Geç bir olayın farklı bir konuşmayı güncelleyememesi için Message kimliğini uygulamanızda tutun.

`player_error` üzerinde, `error_code` gösterin ve Reload source teklif edin; mesajı koruyun ve bir hatadan sonra asla dinlenmiş olarak işaretlemeyin.

Yalnızca oynatma. Uygulamanız dinleme ilerlemesini kaydeder.

Kaydedilen konumda bir dil dersine devam edin

Öğrencilerin tüm dersi yeniden başlatmak yerine zor bir bölümü tekrar oynatmaları gerekir.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; son konum, veritabanınızdaki o öğrenciye ve derse aittir.

Mevcut ders için `ready` olayı gerçekleştikten sonra, kaydedilen saniyelere Seek ve kullanıcının Play bekleyin. Daha yavaş dinleme için Set speed kullanın. İlerlemenizi kendi uygulama iş akışınızla kaydedin.

`current_time` ve `duration` okuyun. `playback_ended` olduğunda, uygulamanız mevcut Lesson için bir dinleme dönüm noktasını kaydedebilir.

Kaynak değiştiyse, o ders yüklenene kadar eski konumu atın. Dinleme tamamlanmasını, öğrencinin konuyu anladığına veya testi geçtiğine dair kanıt olarak değerlendirmeyin.

Yalnızca oynatma. Uygulamanız dinleme ilerlemesini kaydeder.

Zaman damgalı yorumlarla bir ses ekini inceleyin

Editörlerin veya eğitmenlerin bir yorumdan kayıttaki ilgili ana atlaması gerekir.

`source_url = Selected Review’s recording URL`; uygulamaya ait her Yorum kendi saniye değerini saklar; isteğe bağlı `waveform_peaks_json` aynı kayıttaki gerçek tepe noktalarını içerir.

Bir Yorum'a tıklayın → Seek saniyelerine → Play. Kaynak değiştiğinde, tepe noktalarını değiştirin veya temizleyin ve seçili İncelemeyi yeniden bağlayın.

`current_time`'i yorum oluşturucunuzun yanında gösterin. `waveform_available`, UI'nizin gerçek sağlanan tepe noktalarının mevcut olup olmadığını bildirir.

Uygulamanızdaki mevcut süreye karşı eski zaman damgalarını sınırlayın veya reddedin. Gerçek tepe noktaları yoksa, uydurma ses analizi yerine normal ilerleme kontrolünü gösterin.

Yalnızca oynatma. Uygulamanız dinleme ilerlemesini kaydeder.

Şu anda çalışanlar

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.

İş akışını oluşturun

Aşağıdaki mevcut beta eylemlerini kullanın ve sonucu hedef cihazlarınızda test edin.

Bu örnekler Lesson, Message ve Order gibi uygulama kayıtlarını kullanır. Bunları kendi veri tipleriniz ve öğe adlarınızla değiştirin. Örnek medya adresleri kendi dosyalarınızla değiştirilmelidir.

Ses öğesini ekleyin. source_url = Selected Message's audio_url, title = Selected Message's sender_label ve subtitle = Selected Message's date_label ayarlayın.
Bu kayıt için gerçek dalga formu veriniz varsa, waveform_peaks_json içinde gönderin. Aksi takdirde boş bırakın.
ready olayı gerçekleştiğinde, gerekirse kaydedilmiş saniye sayısı ile Seek kullanın. Kullanıcının Play'e basmasına izin verin. Oynatıcı düğmeleri için Pause, Seek ve Set speed kullanın.
current_time ve duration gösterilsin. playback_ended üzerinde, seçili mesaj veya ders için dinleme ilerlemesini kaydedin. is_active'yi bu görünümün açık olup olmadığına ayarlayın.

İş akışı diyagramı — uygulama ekran görüntüsü değil

Bir kez yapılandırın

Bubble uygulama projenizi BestPlugins → Dashboard → Plugins içinde oluşturun veya seçin. Xodera Audio Player Native öğesini seçin, anahtarını kopyalayın, ardından Bubble → Plugins → Xodera Audio Player Native açın ve licensing_api_key içine yapıştırın. Bir kez kaydedin; ardından aşağıdaki eylemleri kullanın. Her proje içindeki her eklentinin kendi anahtarı vardır.

Uygulamanın açabileceği doğrudan bir ses dosyası adresi kullanın. Ses çalmak mikrofon veya kamera erişimi gerektirmez.

Bir kez yapılandırın

Bubble uygulama projenizi BestPlugins → Dashboard → Plugins içinde oluşturun veya seçin.
Bu eklentiyi seçin ve proje anahtarını kopyalayın.
Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
Öğeyi ekleyin, uygulama verilerinizi seçin ve aşağıdaki iş akışını oluşturun.
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.

Kurulum ve abonelik

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.

Sonucu uygulamanıza kaydedin

Örnek ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Kullanıcı dersi duraklattığında veya bıraktığında kaydedin, her ekran güncellemesinde değil.

Başarısızlık, iptal ve kurtarma

player_error üzerinde, error_code gösterin ve Reload source sunun. Mesajı veya ders kaydını tutun. Farklı bir kayıt seçildiğinde, kendi kaydedilmiş konumunu yükleyin. Görünüme geri dönmek oynatmayı otomatik başlatmaz.

Yetenekler ve sınırlamalar

Oynatma hızları: 1, 1.5 ve 2. Ses seviyesi: 0–1. Dalga formu verileri: 2–2048, 0 ile 1 arasındaki değerler. Desteklenen ses formatları cihaza bağlıdır. Oynatıcı ses kaydetmez, metne dönüştürmez veya çevrim dışı kullanım için kalıcı olarak kaydetmez. Arka plan ve kilit ekranı oynatımı garanti edilmez.

Ayarlar, eylemler ve sonuçlar

Bu adları Bubble içinde kullanın. Planlanan özellikler ayrı olarak işaretlenmiştir.

Kullanılabilir beta ayarları

Öğe ayarları

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

Durumlar

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

Olaylar

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Eylemler ve girdileri

PlayPauseToggleStopSeekSet speedSet volumeReload source

Öğe ayarları · 11

source_urltext · Varsayılan: "": Örnek değerhttps://bestplugins.online/native-samples/lesson.mp3; Örnek Bubble ifadesiSelected Message's audio_url; Seçilen ses, video veya görüntü dosyasının adresi. Bu eklentinin desteklediği bir dosya türü kullanın.

waveform_peaks_jsontext · Varsayılan: "": Örnek değer[0.1,0.4,0.2,0.7]; Örnek Bubble ifadesiSelected Message's waveform_peaks_json; Bu kaydın gerçek normalleştirilmiş genlik değerleri; mevcut değilse boş bırakın.

titletext · Varsayılan: "": Örnek değerLesson 4 — review; Örnek Bubble ifadesiSelected Lesson's name; Görünür uygulama metni; boş bırakıldığında destekleniyorsa yerleşik yerelleştirilmiş kopya kullanılır. Kimlik bilgileri yok.

subtitletext · Varsayılan: "": Örnek değerTeacher · today; Örnek Bubble ifadesiSelected Message's sender_label; Görünür uygulama metni; boş bırakıldığında destekleniyorsa yerleşik yerelleştirilmiş kopya kullanılır. Kimlik bilgileri yok.

playback_ratenumber · Varsayılan: 1: Örnek değer1.5; Örnek Bubble ifadesiCurrent User's listening_speed; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

volumenumber · Varsayılan: 1: Örnek değer0.8; Örnek Bubble ifadesiVolume Slider's value; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

loopyes_no · Varsayılan: false: Örnek değerno; Örnek Bubble ifadesiSelected Lesson's repeat_enabled; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

is_activeyes_no · Varsayılan: true: Örnek değeryes; Örnek Bubble ifadesiGuideHost's view_is_active (your yes/no custom state); Bu görünüm açıkken evet ayarlayın. Ayrılırken hayır ayarlayın, böylece oynatma veya mevcut çalışma durabilir.

disabledyes_no · Varsayılan: false: Örnek değerno; Örnek Bubble ifadesiGuideHost's is_busy (your yes/no custom state); Uygulamanız meşgulken veya bu eylem kullanılamazken öğeyi devre dışı bırakın.

ui_text_jsontext · Varsayılan: "": Örnek değer{}; Örnek Bubble ifadesiApp Settings' player_labels_json (supported keys only); Desteklenen düğme etiketleriyle isteğe bağlı JSON. Yerleşik metni kullanmak için boş bırakın.

languagetext · Varsayılan: "auto": Örnek değeruk; Örnek Bubble ifadesiCurrent User's preferred_language; language=auto'yi desteklenen bir cihazı veya tarayıcı dilini izlemek için ayarlayın. Açıkça seçmek için desteklenen bir dil kodu girin.

Eylemler ve girdileri · 8

Play

Eylem parametresi yok

Pause

Eylem parametresi yok

Toggle

Eylem parametresi yok

Stop

Eylem parametresi yok

Seek

secondsnumber · Varsayılan: —: Örnek değer12; Örnek Bubble ifadesiSelected Comment's seconds; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Set speed

ratenumber · Varsayılan: —: Örnek değer1.5; Örnek Bubble ifadesiSpeed Dropdown's value; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Set volume

volumenumber · Varsayılan: —: Örnek değer0.8; Örnek Bubble ifadesiVolume Slider's value; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Reload source

Eylem parametresi yok

Durumlar ve olaylar