Διεπαφή Audio Player με παράδειγμα τίτλου.
Διεπαφή Audio Player με παράδειγμα τίτλου.
← Όλοι οι εγγενείς οδηγοί

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Προσθέστε έναν καθαρό αναπαραγωγέα ήχου σε μαθήματα, φωνητικά μηνύματα ή εγγραφές προϊόντων. Επιτρέψτε στους χρήστες να ακούσουν, να αλλάξουν την ταχύτητα και να συνεχίσουν από την αποθηκευμένη θέση.

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.

Τεκμηρίωση ελέγχθηκε 6 Νοέμβριος 2026

Πρακτικά παραδείγματα

Φωνητικές σημειώσεις μέσα σε μια συνομιλία υποστήριξης

Ένας απλός σύνδεσμος αρχείου αποσπά τους χρήστες από τη συνομιλία και καθιστά δύσκολη την επανεξέταση μεγάλων απαντήσεων.

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

Τοποθετήστε τον αναπαραγωγέα στη λεπτομέρεια του επιλεγμένου μηνύματος. Αφήστε τον χρήστη Play/Pause, Seek σε ένα χρήσιμο σημείο και Set speed. Συνδέστε `is_active` με τη ανοικτή συνομιλία.

Χρησιμοποιήστε `is_playing`, `current_time` και `duration` για να εμφανίσετε την πρόοδο. Διατηρήστε το αναγνωριστικό Message στην εφαρμογή σας ώστε ένα καθυστερημένο γεγονός να μην μπορεί να ενημερώσει διαφορετική συνομιλία.

Στο `player_error`, εμφανίστε `error_code` και προσφέρετε Reload source· διατηρήστε το μήνυμα και μην το σημειώνετε ως ακουσμένο μετά από σφάλμα.

Μόνο αναπαραγωγή. Η εφαρμογή σας αποθηκεύει την πρόοδο ακρόασης.

Συνεχίστε ένα μάθημα γλώσσας στη αποθηκευμένη θέση

Οι μαθητές πρέπει να επαναλάβουν ένα δύσκολο απόσπασμα αντί να ξεκινήσουν ξανά ολόκληρο το μάθημα.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; η τελευταία θέση ανήκει σε αυτόν τον μαθητή και το μάθημα στη βάση δεδομένων σας.

Μετά το `ready` για το τρέχον μάθημα, κάντε Seek στα αποθηκευμένα δευτερόλεπτα και περιμένετε ο χρήστης να Play. Χρησιμοποιήστε το Set speed για πιο αργή ακρόαση. Αποθηκεύστε την πρόοδο με τη δική σας ροή εργασίας της εφαρμογής.

Διαβάστε το `current_time` και το `duration`. Κατά το `playback_ended`, η εφαρμογή σας μπορεί να καταγράψει ένα ορόσημο ακρόασης για το τρέχον Lesson.

Εάν η πηγή άλλαξε, απορρίψτε την παλιά θέση μέχρι να φορτωθεί το μάθημα. Μην θεωρείτε την ολοκλήρωση της ακρόασης ως απόδειξη ότι ο μαθητής κατάλαβε ή πέρασε ένα τεστ.

Μόνο αναπαραγωγή. Η εφαρμογή σας αποθηκεύει την πρόοδο ακρόασης.

Ανασκόπηση ενός ηχητικού συνημμένου με σχόλια χρονικής σήμανσης.

Οι επεξεργαστές ή εκπαιδευτές πρέπει να μεταβούν από ένα σχόλιο στη σχετική στιγμή μιας ηχογράφησης.

`source_url = Selected Review’s recording URL`; κάθε Σχόλιο που ανήκει στην εφαρμογή αποθηκεύει τη δική του τιμή δευτερολέπτων· προαιρετικό το `waveform_peaks_json` περιέχει πραγματικές κορυφές για την ίδια ηχογράφηση.

Κάντε κλικ σε ένα Σχόλιο → Seek στα δευτερόλεπτά του → Play. Κατά την αλλαγή πηγής, αντικαταστήστε ή διαγράψτε τις κορυφές και συνδέστε ξανά την επιλεγμένη Ανασκόπηση.

Εμφανίστε το `current_time` δίπλα στον συντάκτη σχολίων σας. Το `waveform_available` ενημερώνει το UI σας αν υπάρχουν διαθέσιμες πραγματικές κορυφές.

Περιορίστε ή απορρίψτε παλαιά χρονικά σήματα σε σχέση με τη τρέχουσα διάρκεια στην εφαρμογή σας. Όταν δεν υπάρχουν πραγματικές κορυφές, εμφανίστε τον συνηθισμένο έλεγχο προόδου αντί για εφεύρεση ανάλυσης ήχου.

Μόνο αναπαραγωγή. Η εφαρμογή σας αποθηκεύει την πρόοδο ακρόασης.

Τι λειτουργεί τώρα

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.

Δημιουργήστε τη ροή εργασίας

Χρησιμοποιήστε τις διαθέσιμες ενέργειες beta παρακάτω και δοκιμάστε το αποτέλεσμα στις στοχευμένες συσκευές σας.

Αυτά τα παραδείγματα χρησιμοποιούν εγγραφές εφαρμογής όπως Lesson, Message και Order. Αντικαταστήστε τα με τους δικούς σας τύπους δεδομένων και ονόματα στοιχείων. Οι διευθύνσεις μέσων παραδείγματος πρέπει να αντικατασταθούν με τα δικά σας αρχεία.

  1. Προσθέστε το στοιχείο ήχου. Ορίστε source_url = Selected Message's audio_url, title = Selected Message's sender_label και subtitle = Selected Message's date_label.

  2. Εάν έχετε πραγματικά δεδομένα κυματομορφής για αυτήν την ηχογράφηση, περάστε τα στο waveform_peaks_json. Διαφορετικά αφήστε το κενό.

  3. Όταν συμβεί το ready, χρησιμοποιήστε Seek με τον αποθηκευμένο αριθμό δευτερολέπτων εάν χρειάζεται. Επιτρέψτε στον χρήστη να πατήσει Play. Χρησιμοποιήστε Pause, Seek και Set speed για τα κουμπιά του αναπαραγωγέα.

  4. Εμφανίστε current_time και duration. Στο playback_ended, αποθηκεύστε την πρόοδο ακρόασης για το επιλεγμένο μήνυμα ή μάθημα. Ορίστε is_active ανάλογα με το αν αυτή η προβολή είναι ανοιχτή.

Διάγραμμα ροής εργασίας — όχι στιγμιότυπο εφαρμογής

Διαμορφώστε μία φορά

Δημιουργήστε ή επιλέξτε το έργο εφαρμογής Bubble στο BestPlugins → Dashboard → Plugins. Επιλέξτε Xodera Audio Player Native, αντιγράψτε το κλειδί του, στη συνέχεια ανοίξτε Bubble → Plugins → Xodera Audio Player Native και επικολλήστε το στο licensing_api_key. Αποθηκεύστε μία φορά· μετά χρησιμοποιήστε τις ενέργειες παρακάτω. Κάθε plugin σε κάθε έργο έχει το δικό του κλειδί.

Χρησιμοποιήστε μια άμεση διεύθυνση αρχείου ήχου που μπορεί να ανοίξει η εφαρμογή. Η αναπαραγωγή ήχου δεν απαιτεί πρόσβαση σε μικρόφωνο ή κάμερα.

Διαμορφώστε μία φορά
  1. Δημιουργήστε ή επιλέξτε το έργο εφαρμογής Bubble στο BestPlugins → Dashboard → Plugins.
  2. Επιλέξτε αυτό το plugin και αντιγράψτε το κλειδί του έργου.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Προσθέστε το στοιχείο, επιλέξτε τα δεδομένα της εφαρμογής σας και δημιουργήστε τη ροή εργασίας παρακάτω.
  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.
Εγκατάσταση και συνδρομή

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.

Αποθηκεύστε το αποτέλεσμα στην εφαρμογή σας

Παράδειγμα ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Αποθηκεύστε όταν ο χρήστης κάνει παύση ή αφήνει το μάθημα, αντί σε κάθε ενημέρωση οθόνης.

Αποτυχία, ακύρωση και ανάκτηση

Στο player_error, εμφανίστε error_code και προσφέρετε Reload source. Διατηρήστε το μήνυμα ή την εγγραφή μαθήματος. Όταν επιλεγεί διαφορετική ηχογράφηση, φορτώστε τη δική της αποθηκευμένη θέση. Η επιστροφή στην προβολή δεν ξεκινά την αναπαραγωγή αυτόματα.

Δυνατότητες και περιορισμοί

Ταχύτητες αναπαραγωγής: 1, 1.5 και 2. Ένταση: 0–1. Δεδομένα κυματομορφής: 2–2048 τιμές μεταξύ 0 και 1. Οι υποστηριζόμενες μορφές ήχου εξαρτώνται από τη συσκευή. Ο αναπαραγωγέας δεν καταγράφει, δεν μεταγράφει ούτε αποθηκεύει μόνιμα ήχο για χρήση εκτός σύνδεσης. Η αναπαραγωγή στο παρασκήνιο και στην κλειδωμένη οθόνη δεν είναι εγγυημένη.

Ρυθμίσεις, ενέργειες και αποτελέσματα

Χρησιμοποιήστε αυτά τα ονόματα στο Bubble. Τα προγραμματισμένα χαρακτηριστικά σημειώνονται ξεχωριστά.

Διαθέσιμες ρυθμίσεις beta

Ρυθμίσεις στοιχείου

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

Καταστάσεις

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

Συμβάντα

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Ενέργειες και οι εισόδους τους

PlayPauseToggleStopSeekSet speedSet volumeReload source
Ρυθμίσεις στοιχείου · 11
source_urltext · Προεπιλογή: ""
Παράδειγμα τιμήςhttps://bestplugins.online/native-samples/lesson.mp3
Παράδειγμα έκφρασης BubbleSelected Message's audio_url
Διεύθυνση του επιλεγμένου αρχείου ήχου, βίντεο ή εικόνας. Χρησιμοποιήστε έναν τύπο αρχείου που υποστηρίζει αυτό το πρόσθετο.
waveform_peaks_jsontext · Προεπιλογή: ""
Παράδειγμα τιμής[0.1,0.4,0.2,0.7]
Παράδειγμα έκφρασης BubbleSelected Message's waveform_peaks_json
Πραγματικές κανονικοποιημένες τιμές πλάτους για αυτήν την ηχογράφηση· αφήστε κενό αν δεν είναι διαθέσιμες.
titletext · Προεπιλογή: ""
Παράδειγμα τιμήςLesson 4 — review
Παράδειγμα έκφρασης BubbleSelected Lesson's name
Ορατό κείμενο της εφαρμογής· το κενό χρησιμοποιεί το ενσωματωμένο τοπικοποιημένο κείμενο όπου υποστηρίζεται. Χωρίς διαπιστευτήρια.
subtitletext · Προεπιλογή: ""
Παράδειγμα τιμήςTeacher · today
Παράδειγμα έκφρασης BubbleSelected Message's sender_label
Ορατό κείμενο της εφαρμογής· το κενό χρησιμοποιεί το ενσωματωμένο τοπικοποιημένο κείμενο όπου υποστηρίζεται. Χωρίς διαπιστευτήρια.
playback_ratenumber · Προεπιλογή: 1
Παράδειγμα τιμής1.5
Παράδειγμα έκφρασης BubbleCurrent User's listening_speed
Χρησιμοποιήστε την τιμή του τρέχοντος επιχειρηματικού αρχείου· επαληθεύστε την έναντι των παρακάτω ορίων.
volumenumber · Προεπιλογή: 1
Παράδειγμα τιμής0.8
Παράδειγμα έκφρασης BubbleVolume Slider's value
Χρησιμοποιήστε την τιμή του τρέχοντος επιχειρηματικού αρχείου· επαληθεύστε την έναντι των παρακάτω ορίων.
loopyes_no · Προεπιλογή: false
Παράδειγμα τιμήςno
Παράδειγμα έκφρασης BubbleSelected Lesson's repeat_enabled
Χρησιμοποιήστε την τιμή του τρέχοντος επιχειρηματικού αρχείου· επαληθεύστε την έναντι των παρακάτω ορίων.
is_activeyes_no · Προεπιλογή: true
Παράδειγμα τιμήςyes
Παράδειγμα έκφρασης BubbleGuideHost's view_is_active (your yes/no custom state)
Ορίστε ναι ενώ αυτή η προβολή είναι ανοιχτή. Ορίστε όχι κατά την έξοδο, ώστε η αναπαραγωγή ή η τρέχουσα εργασία να μπορεί να σταματήσει.
disabledyes_no · Προεπιλογή: false
Παράδειγμα τιμήςno
Παράδειγμα έκφρασης BubbleGuideHost's is_busy (your yes/no custom state)
Απενεργοποιήστε το στοιχείο ενώ η εφαρμογή σας είναι απασχολημένη ή αυτή η ενέργεια δεν είναι διαθέσιμη.
ui_text_jsontext · Προεπιλογή: ""
Παράδειγμα τιμής{}
Παράδειγμα έκφρασης BubbleApp Settings' player_labels_json (supported keys only)
Προαιρετικό JSON με υποστηριζόμενες ετικέτες κουμπιών. Αφήστε κενό για χρήση του ενσωματωμένου κειμένου.
languagetext · Προεπιλογή: "auto"
Παράδειγμα τιμήςuk
Παράδειγμα έκφρασης BubbleCurrent User's preferred_language
Ορίστε language=auto ώστε να ακολουθεί μια υποστηριζόμενη συσκευή ή γλώσσα προγράμματος περιήγησης. Εισάγετε έναν υποστηριζόμενο κωδικό γλώσσας για να τον επιλέξετε ρητά.
Ενέργειες και οι εισόδους τους · 8
Play

Δεν υπάρχουν παράμετροι ενέργειας

Pause

Δεν υπάρχουν παράμετροι ενέργειας

Toggle

Δεν υπάρχουν παράμετροι ενέργειας

Stop

Δεν υπάρχουν παράμετροι ενέργειας

Seek
secondsnumber · Προεπιλογή: —
Παράδειγμα τιμής12
Παράδειγμα έκφρασης BubbleSelected Comment's seconds
Χρησιμοποιήστε την τιμή του τρέχοντος επιχειρηματικού αρχείου· επαληθεύστε την έναντι των παρακάτω ορίων.
Set speed
ratenumber · Προεπιλογή: —
Παράδειγμα τιμής1.5
Παράδειγμα έκφρασης BubbleSpeed Dropdown's value
Χρησιμοποιήστε την τιμή του τρέχοντος επιχειρηματικού αρχείου· επαληθεύστε την έναντι των παρακάτω ορίων.
Set volume
volumenumber · Προεπιλογή: —
Παράδειγμα τιμής0.8
Παράδειγμα έκφρασης BubbleVolume Slider's value
Χρησιμοποιήστε την τιμή του τρέχοντος επιχειρηματικού αρχείου· επαληθεύστε την έναντι των παρακάτω ορίων.
Reload source

Δεν υπάρχουν παράμετροι ενέργειας

Καταστάσεις και συμβάντα

Καταστάσεις

player_status · text

Τρέχον αποτέλεσμα αυτής της ενέργειας. Χρησιμοποιήστε το αντίστοιχο γεγονός ολοκλήρωσης πριν αποθηκεύσετε την επιτυχία.

is_playing · yes_no

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

is_loaded · yes_no

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

is_buffering · yes_no

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

current_time · number

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

duration · number

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

progress · number

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

playback_rate · number

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

volume · number

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

is_looping · yes_no

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

waveform_available · yes_no

Τρέχουσα τιμή για το επιλεγμένο στοιχείο. Διαβάστε την μετά το σχετικό γεγονός.

waveform_status · text

Τρέχον αποτέλεσμα αυτής της ενέργειας. Χρησιμοποιήστε το αντίστοιχο γεγονός ολοκλήρωσης πριν αποθηκεύσετε την επιτυχία.

error_code · text

Πληροφορίες σφάλματος για την τελευταία ενέργεια. Εμφανίστε ένα χρήσιμο μήνυμα και προσφέρετε την σχετική επανάληψη.

Συμβάντα

ready

Όταν συμβεί αυτό το γεγονός, διαβάστε τις σχετικές καταστάσεις από το ίδιο στοιχείο.

playback_started

Όταν συμβεί αυτό το γεγονός, διαβάστε τις σχετικές καταστάσεις από το ίδιο στοιχείο.

playback_paused

Όταν συμβεί αυτό το γεγονός, διαβάστε τις σχετικές καταστάσεις από το ίδιο στοιχείο.

playback_ended

Όταν συμβεί αυτό το γεγονός, διαβάστε τις σχετικές καταστάσεις από το ίδιο στοιχείο.

seek_completed

Όταν συμβεί αυτό το γεγονός, διαβάστε τις σχετικές καταστάσεις από το ίδιο στοιχείο.

rate_changed

Όταν συμβεί αυτό το γεγονός, διαβάστε τις σχετικές καταστάσεις από το ίδιο στοιχείο.

player_error

Όταν συμβεί αυτό το γεγονός, διαβάστε τις σχετικές καταστάσεις από το ίδιο στοιχείο.

Ερωτήσεις που κάνουν οι προγραμματιστές

Δημιουργεί το κυματογράφημα;

Όχι. Παρέχετε πραγματικές κανονικοποιημένες κορυφές για αυτή την πηγή· η κανονική πρόοδος λειτουργεί χωρίς αυτές.

Πώς λειτουργεί η συνδρομή;

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.

Σχετικοί οδηγοί

Για βοήθεια, πείτε μας ποιο plugin και ποια συσκευή χρησιμοποιείτε, τη δράση που δοκιμάσατε και τι συνέβη. Χρησιμοποιήστε ένα παράδειγμα χωρίς προσωπικά δεδομένα. Ποτέ μην μοιράζεστε το κλειδί ή τα ιδιωτικά σας αρχεία.