Audio Recorder ինտերֆեյս.
Audio Recorder ինտերֆեյս.
← Բոլոր նատիվ ուղեցույցները

Xodera Plugins · Bubble Native

Xodera Audio Recorder 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

Պրակտիկ օրինակներ

Լսեք, նախքան ոչ գաղտնի ձայնային հաղորդագրություն ուղարկելը

Օգտագործողներին պետք է լինի հնարավորություն լսել և փոխարինել ձայնագրությունը, նախքան այն կցված ֆայլի դարձնելը։

`title = the app’s conversation label`; սահմանեք `max_duration_seconds` և `max_upload_bytes` ձեր հաղորդագրության քաղաքականության համար։

Start recording → Stop recording → սպասեք `recording_ready` → Play preview։ Առաջարկեք Seek preview և Set preview speed։ Միայն հստակ «Ուղարկել» հրամանը է կանչում Upload to Bubble ընդունված սեփական հավելվածի վերբեռնման վերջնակետում։

Միայն `upload_succeeded`-ում, ստեղծեք ձեր Message և սահմանեք նրա ձայնային դաշտը `uploaded_file`-ի։ Հաղորդագրությունը չի ստեղծվում ինքնուրույն ձայնագրիչի կողմից։

Միկրոֆոնի մերժման դեպքում ցույց տվեք `permission_status`; վերբեռնման ձախողման դեպքում պահեք տեղական ձայնագրությունը։ Վերբեռնումը կրկին փորձելուց առաջ ստուգեք անհայտ վերբեռնման արդյունքը, որպեսզի «Ուղարկել» չկարողանա ստեղծել կրկնակի կցված ֆայլեր/հաղորդագրություններ։

Bubble վերբեռնումը ստեղծում է հանրային ձայնային ֆայլ։ Մի օգտագործեք այս վերբեռնումը գաղտնի ձայնագրությունների համար։

Արտասխանի պրակտիկա առանց անմիջական վերբեռնման

Սովորողները ցանկանում են համեմատել իրենց խոսված պատասխանը դասի հետ, նախքան այն ներկայացնելու որոշումը։

`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; վարժության պատասխանը մնում է հավելվածի սեփական գրառումը։

Ձայնագրել → Դադարեցնել → Play preview։ Թույլ տվեք սովորողին անցնել ձայնագրության այլ պահի, դանդաղեցնել նախադիտումը կամ չեղարկել և ձայնագրել նոր փորձ։ Save locally միայն այն դեպքում, երբ նրանք ընտրում են պահել սևագիրը։

`duration`, `local_uri`, `mime_type` և `draft_id` նկարագրում են փորձը։ Ձեր հավելվածը որոշում է, թե այն մնա տեղական, թե հետագայում ներկայացվի ձեր ընտրված վերբեռնման աշխատանքային հոսքի միջոցով։

`preview_error`-ի դեպքում պահեք սևագիրը և ցույց տվեք `error_code`։ Մի դարձնեք նախադիտումը կամ պահպանված սևագիրը ներկայացված Պատասխան, մինչև հավելվածի ներկայացման աշխատանքային հոսքը հաջողվի։

Bubble վերբեռնումը ստեղծում է հանրային ձայնային ֆայլ։ Մի օգտագործեք այս վերբեռնումը գաղտնի ձայնագրությունների համար։

Պահեք տեղական ձայնային սևագիր և դարձնեք «Ուղարկել» հստակ

Դաշտում աշխատողը կարող է ընդհատվել նշումը ավարտելուց առաջ և չպետք է պետք լինի վերբեռնել այն միայն պահպանելու համար։

`saved_draft_id = the draft ID stored by your app for this device and account`; `title = the selected non-sensitive task label`.

Start/Stop recording → Save locally։ Վերադարձված `draft_id`-ը պահեք ձեր հավելվածի՝ տվյալ սարքով և հաշվով սահմանափակված վիճակում։ Այդ նույն ID-ի համար օգտագործեք Restore local draft, ապա Play preview՝ նախքան վերբեռնելու որոշումը։

`local_saved` կամ `local_restored`-ի դեպքում, ստուգեք `is_saved_locally`, `local_uri` և `duration`։ Միայն հստակ օգտվողի ընտրության կամ առանձին հաստատված պահպանումի քաղաքականության դեպքում ջնջեք պահպանված սևագիրը։

Եթե վերականգնումը ձախողում է, ցույց տվեք `error_code` և պահեք ID-ն ախտորոշման համար; մի զեկուցեք դատարկ կամ տարբեր ձայնագրություն որպես վերականգնված։ Երբեք չկատարեք auto-վերբեռնումը վերակապի դեպքում։

Bubble վերբեռնումը ստեղծում է հանրային ձայնային ֆայլ։ Մի օգտագործեք այս վերբեռնումը գաղտնի ձայնագրությունների համար։

Ինչ է աշխատում հիմա

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.

Ստեղծեք աշխատանքային հոսքը

Օգտագործեք ներքևում մատչելի բետա գործողությունները և փորձարկեք արդյունքը ձեր նպատակային սարքերում։

Այս օրինակները օգտագործում են հավելվածի գրառումներ, ինչպիսիք են Lesson, Message և Order։ Փոխարինեք դրանք ձեր տվյալների տեսակներով և տարրերի անուններով։ Օրինակների մեդիա հասցեները պետք է փոխարինվեն ձեր սեփական ֆայլերով։

  1. Ավելացրեք ձայնագրիչը։ Սահմանեք document_context = Current User's unique id և is_active՝ արդյոք ձայնագրության տեսքը բաց է։

  2. Start recording հարցնում է միկրոֆոնի թույլտվություն։ Pause և Resume գործողությունները պահում են նույն ձայնագրությունը։ Stop recording ավարտում է այն; սպասեք recording_ready-ին, նախքան վերանայման կամ վերբեռնման առաջարկը։

  3. Օգտագործեք նախադիտման կառավարման տարրերը լսելու համար։ Save locally պահում է սևագիր այս սարքում; local_saved-ի հետո, պահեք draft_id՝ Restore local draft-ի համար։

  4. Բացատրեք, որ ուղարկումը ստեղծում է հանրային ֆայլ։ Սահմանեք bubble_upload_url ձեր սեփական Bubble հավելվածի ճիշտ Development կամ Live ֆայլ-վերբեռնման հասցեն։ Գործարկեք Upload to Bubble միայն, երբ օգտատերը ընտրում է Ուղարկել; upload_succeeded-ի դեպքում, պահպանեք uploaded_file ձեր գրառման մեջ։

Աշխատանքային հոսքի դիագրամ — ոչ հավելվածի սկրինշոտ

Կարգավորեք մեկ անգամ

Ստեղծեք կամ ընտրեք ձեր Bubble հավելվածի նախագիծը BestPlugins → Dashboard → Plugins-ում։ Ընտրեք Xodera Audio Recorder Native, պատճենեք նրա բանալին, ապա բացեք Bubble → Plugins → Xodera Audio Recorder Native և տեղադրեք այն licensing_api_key-ում։ Պահպանեք մեկ անգամ; ապա օգտագործեք ներքևում գտնվող գործողությունները։ Յուրաքանչյուր պլագին յուրաքանչյուր նախագծում ունի իր սեփական բանալին։

Խնդրեք միկրոֆոնի թույլտվություն, երբ օգտատերը սկսում է ձայնագրել։ Ընտրեք, թե ինչպես հավելվածը կպահպանի սևագրերը։ Bubble վերբեռնումը պահում է հանրային ֆայլ, ուստի օգտագործեք այն միայն հանրային պահման համար համապատասխան ձայնագրությունների համար։

Կարգավորեք մեկ անգամ
  1. Ստեղծեք կամ ընտրեք ձեր Bubble հավելվածի նախագիծը BestPlugins → Dashboard → Plugins-ում։
  2. Ընտրեք այս պլագինը և պատճենեք նրա նախագծի բանալին։
  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.

Պահպանեք արդյունքը ձեր հավելվածում

upload_succeeded-ի հետո, սահմանեք VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration և mime_type = Recorder's mime_type։ draft_id վերականգնում է սևագիրը այս սարքում; այն առցանց ձայնային ֆայլ չէ։

Ձախողում, չեղարկում և վերականգնում

Եթե միկրոֆոնի հասանելիությունը մերժված է, բացատրեք, թե ինչպես այն միացնել սարքի կարգավորումներում։ Cancel recording հեռացնում է չպահված ձայնագրությունը; պահպանված սևագրերը մնում են։ Եթե վերբեռնումը ընդհատված է, պահեք տեղական ձայնագրությունը և ստուգեք, արդյոք ֆայլը հասել է, նախքան այն կրկին ուղարկելը։ Delete saved draft հեռացնում է միայն ընտրված պահպանված սևագիրը։

Հնարավորություններ և սահմանափակումներ

Լռելյայն առավելագույն ձայնագրություն՝ 300 վայրկյան; կարգավորելի 1–3600։ Լռելյայն վերբեռնման սահմանափակում՝ 10 MiB; առավելագույնը 30 MiB։ Վերբեռնման ժամանակի ավարտ՝ 60 վայրկյան, առանց ավտոմատ կրկնակի փորձի։ Bubble վերբեռնումները հանրային են։ Միայն ձեր *.bubbleapps.io ֆայլ-վերբեռնման հասցեները են աջակցված; հատուկ դոմենները չեն։ Տեղական սևագրերը չեն գաղտնագրված պահոց։

Կարգավորումներ, գործողություններ և արդյունքներ

Օգտագործեք այս անունները Bubble-ում։ Պլանավորված հատկությունները նշված են առանձին.

Մատչելի բետա կարգավորումներ

Էլեմենտի կարգավորումներ

title · textmax_duration_seconds · numbermax_upload_bytes · numberis_active · yes_nodisabled · yes_noui_text_json · textsaved_draft_id · textbubble_upload_url · textlanguage · textdocument_context · text

Կարգավիճակներ

recorder_status · textpermission_status · textis_recording · yes_nois_paused · yes_noduration · numberlocal_uri · textdraft_id · textis_saved_locally · yes_nomime_type · textfile_size · numberwaveform_peaks_json · textpreview_status · textpreview_is_playing · yes_nopreview_current_time · numberupload_status · textupload_progress · numberuploaded_url · textuploaded_file · fileerror_code · text

Իրադարձություններ

recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_error

Գործողություններ և դրանց մուտքերը

Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speed
Էլեմենտի կարգավորումներ · 10
titletext · Դեֆոլտ: ""
Օրինակային արժեքLesson 4 — review
Օրինակ Bubble արտահայտությունSelected Lesson's name
Հավելվածում տեսանելի տեքստ․ դատարկ թողնելու դեպքում օգտագործվում է ներկառուցված տեղայնացված տեքստը, եթե այն աջակցվում է։ Մի մուտքագրեք մուտքի գաղտնի տվյալներ։
max_duration_secondsnumber · Դեֆոլտ: 300
Օրինակային արժեք300
Օրինակ Bubble արտահայտությունVoice Settings' max_seconds
Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։
max_upload_bytesnumber · Դեֆոլտ: 10485760
Օրինակային արժեք10485760
Օրինակ Bubble արտահայտությունVoice Settings' max_upload_bytes
Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։
is_activeyes_no · Դեֆոլտ: true
Օրինակային արժեքyes
Օրինակ Bubble արտահայտությունGuideHost's view_is_active (your yes/no custom state)
Սահմանեք yes, քանի դեռ այս տեսքը բաց է։ Դուրս գալիս սահմանեք no, որպեսզի նվագարկումը կամ ընթացիկ աշխատանքը կարողանա դադարել։
disabledyes_no · Դեֆոլտ: false
Օրինակային արժեքno
Օրինակ Bubble արտահայտությունGuideHost's is_busy (your yes/no custom state)
Անջատեք տարրը, երբ ձեր հավելվածը զբաղված է կամ այս գործողությունը անհասանելի է։
ui_text_jsontext · Դեֆոլտ: ""
Օրինակային արժեք{}
Օրինակ Bubble արտահայտությունApp Settings' player_labels_json (supported keys only)
Ընտրական JSON՝ աջակցված կոճակների պիտակներով։ Դատարկ թողեք՝ օգտագործելով ներառված տեքստը։
saved_draft_idtext · Դեֆոլտ: ""
Օրինակային արժեք<returned draft_id>
Օրինակ Bubble արտահայտությունSelected VoiceDraft's draft_id
Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։
bubble_upload_urltext · Դեֆոլտ: ""
Օրինակային արժեքhttps://your-app.bubbleapps.io/version-test/fileupload
Օրինակ Bubble արտահայտությունApp Settings' selected_bubble_upload_url
Ձեր սեփական Bubble հավելվածի ֆայլի վերբեռնման հասցեն՝ /version-test/fileupload՝ Development-ի համար, /fileupload՝ Live-ի համար։ Այս վերբեռնումը ստեղծում է հանրային ֆայլեր։
languagetext · Դեֆոլտ: "auto"
Օրինակային արժեքuk
Օրինակ Bubble արտահայտությունCurrent User's preferred_language
Սահմանեք language=auto՝ հետևելու աջակցված սարքին կամ բրաուզերի լեզվին։ Մուտքագրեք աջակցված լեզվի կոդ՝ այն բացահայտ ընտրելու համար։
document_contexttext · Դեֆոլտ: ""
Օրինակային արժեք<current-user-id>
Օրինակ Bubble արտահայտությունCurrent User's unique id
Այս հաշվի կամ գրառման կայուն արժեք։ Օգտագործեք նույն արժեքը, երբ վերականգնում եք նրա պահպանված ֆայլերը կամ սևագրերը։
Գործողություններ և դրանց մուտքերը · 15
Start recording

Չկան գործողության պարամետրեր

Pause recording

Չկան գործողության պարամետրեր

Resume recording

Չկան գործողության պարամետրեր

Stop recording

Չկան գործողության պարամետրեր

Cancel recording

Չկան գործողության պարամետրեր

Save locally

Չկան գործողության պարամետրեր

Restore local draft
draft_idtext · Դեֆոլտ: —
Օրինակային արժեք<returned draft_id>
Օրինակ Bubble արտահայտությունSelected VoiceDraft's draft_id
Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։
Delete saved draft
draft_idtext · Դեֆոլտ: —
Օրինակային արժեք<returned draft_id>
Օրինակ Bubble արտահայտությունSelected VoiceDraft's draft_id
Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։
Upload to Bubble

Չկան գործողության պարամետրեր

Cancel upload

Չկան գործողության պարամետրեր

Play preview

Չկան գործողության պարամետրեր

Pause preview

Չկան գործողության պարամետրեր

Stop preview

Չկան գործողության պարամետրեր

Seek preview
secondsnumber · Դեֆոլտ: —
Օրինակային արժեք12
Օրինակ Bubble արտահայտությունSelected Comment's seconds
Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։
Set preview speed
ratenumber · Դեֆոլտ: —
Օրինակային արժեք1.5
Օրինակ Bubble արտահայտությունPreview Speed Dropdown's value
Օգտագործեք ընթացիկ բիզնես գրառման արժեքը՝ ստուգելով այն ներքևում նշված սահմանների նկատմամբ։
Վիճակներ և իրադարձություններ

Կարգավիճակներ

recorder_status · text

Այս գործողության ընթացիկ արդյունքը։ Օգտագործեք համապատասխան ավարտման իրադարձությունը, նախքան հաջողության պահպանումը։

permission_status · text

Այս գործողության ընթացիկ արդյունքը։ Օգտագործեք համապատասխան ավարտման իրադարձությունը, նախքան հաջողության պահպանումը։

is_recording · yes_no

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

is_paused · yes_no

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

duration · number

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

local_uri · text

Ֆայլի տեղադրությունը այս սարքում։ Եթե պետք է պահվի առցանց, պահպանեք կամ վերբեռնեք ֆայլը առանձին։

draft_id · text

Այս տարրի կամ գործողության նույնացուցիչը։ Պահեք այն համապատասխան հավելվածի գրառման հետ։ Օգտագործեք նույն հարցման նույնացուցիչը, երբ կրկին փորձում եք անորոշ արդյունք։

is_saved_locally · yes_no

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

mime_type · text

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

file_size · number

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

waveform_peaks_json · text

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

preview_status · text

Այս գործողության ընթացիկ արդյունքը։ Օգտագործեք համապատասխան ավարտման իրադարձությունը, նախքան հաջողության պահպանումը։

preview_is_playing · yes_no

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

preview_current_time · number

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

upload_status · text

Այս գործողության ընթացիկ արդյունքը։ Օգտագործեք համապատասխան ավարտման իրադարձությունը, նախքան հաջողության պահպանումը։

upload_progress · number

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

uploaded_url · text

Ընտրված տարրի ընթացիկ արժեքը։ Կարդացեք այն կապված իրադարձությունից հետո։

uploaded_file · file

Ֆայլը վերադարձավ upload_succeeded-ի հետո։ Պահպանեք այն ձեր Bubble File դաշտում։

error_code · text

Վերջին գործողության սխալի տեղեկատվությունը։ Ցուցադրեք օգտակար հաղորդագրություն և առաջարկեք համապատասխան կրկնակի փորձ։

Իրադարձություններ

recording_started

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

recording_paused

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

recording_resumed

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

recording_stopped

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

recording_ready

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

recording_cancelled

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

recorder_error

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

local_saved

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

local_restored

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

local_deleted

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

upload_succeeded

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

upload_failed

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

upload_cancelled

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

preview_ready

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

preview_error

Երբ այս իրադարձությունը տեղի է ունենում, կարդացեք կապված վիճակները նույն տարրից։

Հարցեր, որոնք հարցնում են ծրագրավորողները

Արդյոք տեղական պահպանումը վերբեռնում է ձայնագրությունը։

Ոչ։ Save locally-ը սարքում պահում է տվյալ սեփականատիրոջը պատկանող սևագիրը։ Upload to Bubble-ը առանձին, հստակ ընտրվող հանրային վերբեռնման գործողություն է։

Ինչպե՞ս է աշխատում բաժանորդագրությունը?

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.

Առնչվող ուղեցույցներ

Օգնության համար նշեք, թե որ պլագինն ու սարքն եք օգտագործում, ինչ գործողություն եք փորձել և ինչ է տեղի ունեցել։ Օգտագործեք օրինակ առանց անձնական տվյալների։ Երբեք մի փոխանցեք ձեր բանալին կամ անձնական ֆայլերը։