Xodera Plugins · Bubble Native
Xodera Offline Files Native
Hesabat əlavələrini və seçilmiş faylları cihazda saxlayın, daha sonra bərpa edin və istifadəçiyə seçilmiş nüsxəni paylaşmağa icazə 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.
Sənədlər 6 Noyabr 2026 tarixində nəzərdən keçirildi.
Praktik nümunələr
Hesabat göndərmədən əvvəl bir neçə yerli əlavə hazırlayın
Form seçilmiş faylları göstərməli və istifadəçiyə bulud göndərilməsindən əvvəl idarə olunan nüsxəni saxlamağa icazə verməlidir.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; `max_files`, `max_file_bytes` və hesab/hesabat `document_context` təyin edin.
Pick files → seçilmiş adları/ölçüləri yoxlayın → Save selection locally. Formunuz nəticə fayl ID-lərini saxlayır, ayrı Submit iş axını təsdiqlənmiş faylları yükləyənə qədər.
`selection_count`, `file_names`, `file_sizes` və `saved_file_ids` istifadə edərək icmal siyahısını göstərin. Saxlanılmış idarə olunan nüsxə çağıranın orijinalını qoruyur.
Ləğv edilmiş seçici təqdim edilmiş hesabat deyil. `files_error`-də artıq qəbul edilmiş yerli ID-ləri saxlayın və `error_code` göstərin; yalnız yerli URI-dən bulud əlavə yaratmayın.
Fayllar bu cihazda paylaşılana və ya ayrıca yüklənənə qədər qalır.
Foto-redaktor və ya qeyd edici çıxışını sonradan istifadə üçün saxlayın.
Yaradılmış yerli fayl müvəqqəti yerdə yerləşə bilər; tətbiq açıq idarə olunan nüsxə tələb edir.
`source_uri = the local output of a separately accepted editor/recorder`; onun real `display_name` və `mime_type` bağlayın; eyni sahibin `document_context`‑ni istifadə edin.
Load local source → metadata‑ni yoxlayın → Save selection locally. Geri qaytarılan fayl ID‑ni yalnız uyğun cihaz/kontekstdə saxlayın, sonra lazım olduqda həmin dəqiq ID‑yə görə Restore saved file edin.
`file_id`, `local_uri`, `size_bytes` və `is_saved_locally`‑dən istifadə edin; yalnız sorğu göndərməkdən fərqli olaraq tam bərpanı göstərmək üçün `file_restored`‑ni istifadə edin.
Uzaq HTTP URL‑ni yerli mənbə kimi rədd edin. Mənbə yoxdursa və ya bərpa uğursuz olarsa, `error_code` göstərin və bərpa üçün orijinal tətbiq qeydlərini qoruyun.
Fayllar bu cihazda paylaşılana və ya ayrıca yüklənənə qədər qalır.
İstifadəçiyə tətbiq tərəfindən yaradılmış yerli qəbzi və ya ixracı paylaşmağa icazə verin.
Tətbiq seçilmiş yerli faylı cihazın paylaşma panelinə verməlidir, ictimai URL yaratmaq yerinə.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; onun adı və MIME real yerli faylı təsvir edir.
İstifadəçi Paylaş düyməsini basdıqdan sonra List saved files → Restore saved file → Share selected file. Saxlanılmış nüsxəni onlar açıq şəkildə Delete saved copy‑ni seçənə qədər saxlayın.
Paylaşma paneli bağlandıqdan sonra UI‑ni yeniləmək üçün `share_status` və `share_sheet_closed`‑dən istifadə edin. Başqa məqsədli paylaşım üçün fayl ID‑ni saxlayın.
Paylaşma panelinin bağlanması e-poçtun və ya mesajın çatdırıldığını sübut etmir. Ləğvi və `files_error` hadisəsini alıcıya çatdırılmanın uğurlu olduğunu bildirmədən idarə edin.
Fayllar bu cihazda paylaşılana və ya ayrıca yüklənənə qədər qalır.
İndi işləyənlər
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.
İş axınını yaradın
Aşağıdakı mövcud beta əməliyyatlarından istifadə edin və nəticəni hədəf cihazlarınızda test edin.
Bu nümunələr Lesson, Message və Order kimi tətbiq qeydlərindən istifadə edir. Onları öz məlumat tipləriniz və element adlarınızla əvəz edin. Nümunə media ünvanları öz fayllarınızla dəyişdirilməlidir.
document_context = Current User's unique id təyin edin, ya da hesab və hesabat üçün sabit dəyər. accepted_mime_types_json, max_files və max_file_bytes seçin.
Pick files işə salın, ya da Photo Editor və ya Recorder tərəfindən yaradılan oxunaqlı fayl üçün Load local source istifadə edin. selection_changed-dən sonra uyğun fayl siyahılarını oxuyun; Select picked file indeks seçir.
Save selection locally işə salın. files_saved-dən sonra saved_file_ids-i tətbiqinizin yerli əlavə qeydlərində saxlayın. List saved files saxlanılan nüsxələri göstərir; Restore saved file seçilmiş saxlanılan ID-ni açır.
Share selected file sistem paylaşma menyusunu açır. share_sheet_closed yalnız menyunun bağlandığını bildirir. Delete saved copy seçilmiş ID və confirm=yes tələb edir.
Bir dəfə konfiqurasiya edin
BestPlugins → Dashboard → Plugins daxilində Bubble tətbiq layihənizi yaradın və ya seçin. Xodera Offline Files Native seçin, onun açarını kopyalayın, sonra Bubble → Plugins → Xodera Offline Files Native açın və licensing_api_key‑yə yapışdırın. Bir dəfə yadda saxlayın; sonra aşağıdakı əməliyyatlardan istifadə edin. Hər layihədəki hər pluginin öz açarı var.
Seçilmiş fayllara giriş imkanı olan Bubble Native tətbiqindən istifadə edin. Hesab və ya hesabat üçün sabit document_context təyin edin ki, saxlanılan fayllar düzgün qruplaşsın.
Bir dəfə konfiqurasiya edin
- BestPlugins → Dashboard → Plugins‑də Bubble tətbiq layihənizi yaradın və ya seçin.
- Bu plugin seçin və layihə açarını kopyalayın.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Elementi əlavə edin, tətbiq məlumatlarınızı seçin və aşağıdakı iş axınını yaradın.
- 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.
Quraşdırma və abunə
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.
Nəticəni tətbiqinizdə saxlayın
Nümunə LocalAttachment: sahibi, document_context, saxlanılan fayl ID-si, display_name, mime_type və size_bytes. Bu ID yalnız eyni cihazda və eyni hesabda və ya hesabatda işləyir. Onlayn əlavə üçün faylı ayrı bir iş axını ilə yükləyin və qaytarılan onlayn fayl istinadını yadda saxlayın.
Uğursuzluq, ləğv və bərpa
Ləğv edilmiş seçici operation_cancelled qaytarır; forma göndərilmir. native_pending=yes zamanı, başqa birini açmadan əvvəl fayl seçicisinin və ya paylaşma menyusunun bağlanmasını gözləyin. Clear session cari seçimi təmizləyir, lakin saxlanılan nüsxələri saxlayır. Fayl çatışmırsa, istifadəçiyə onu yenidən seçməyə icazə verin.
İmkanlar və məhdudiyyətlər
Bir anda 1–20 faylları seçin. Hər fayl üçün limit: 1 bayt–256 MiB, seçsəniz daha aşağı limit ola bilər. Fayl növü filtrləri faylları virus üçün yoxlamır. Cihaz fayl ID-ləri və yolları buluddan endirmə bağlantıları kimi işləməz. Yerli nüsxələr şifrələnmiş yaddaş deyil və tətbiq məlumatları silindiyi halda itə bilər.
Ayarlar, əməliyyatlar və nəticələr
Bu adları Bubble-də istifadə edin. Planlaşdırılmış xüsusiyyətlər ayrı şəkildə işarələnir.
Mövcud beta ayarları
Element ayarları
source_uri · textdisplay_name · textmime_type · textdocument_context · textselected_file_id · textaccepted_mime_types_json · textmultiple · yes_nocopy_to_cache · yes_nomax_files · numbermax_file_bytes · numberis_active · yes_nodisabled · yes_noshow_controls · yes_nolanguage · textui_text_json · texttitle · textVəziyyətlər
status · textis_busy · yes_nonative_pending · yes_nooperation · textselection_count · numberselected_index · numberfile_id · textlocal_uri · textdisplay_name · textmime_type · textmime_source · textsize_bytes · numberis_saved_locally · yes_nofile_ids · text (siyahı)file_uris · text (siyahı)file_names · text (siyahı)file_mime_types · text (siyahı)file_sizes · number (siyahı)files_json · textsaved_count · numbersaved_file_ids · text (siyahı)saved_file_uris · text (siyahı)saved_file_names · text (siyahı)saved_file_mime_types · text (siyahı)saved_file_sizes · number (siyahı)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textHadisələr
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorƏməliyyatlar və onların girişləri
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionElement ayarları · 16
source_uritext · Standart: ""- Nümunə dəyəri
file:///app-cache/report.pdf - Nümunə Bubble ifadəsi
Photo Editor's output_uri - Bu cihazda oxuna bilən fayl yeri, seçiciniz və ya başqa bir plugin tərəfindən qaytarılır.
display_nametext · Standart: ""- Nümunə dəyəri
report-photo.jpg - Nümunə Bubble ifadəsi
Selected Attachment's display_name - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
mime_typetext · Standart: ""- Nümunə dəyəri
image/jpeg - Nümunə Bubble ifadəsi
Photo Editor's output_mime - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
document_contexttext · Standart: "default"- Nümunə dəyəri
<current-user-id> - Nümunə Bubble ifadəsi
Current User's unique id - Bu hesab və ya qeyd üçün sabit dəyər. Saxlanılmış faylları və ya qaralamaları bərpa edərkən eyni dəyəri istifadə edin.
selected_file_idtext · Standart: ""- Nümunə dəyəri
<returned saved file ID> - Nümunə Bubble ifadəsi
Selected LocalAttachment's local_file_id - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
accepted_mime_types_jsontext · Standart: "[\"*/*\"]"- Nümunə dəyəri
["image/*","application/pdf"] - Nümunə Bubble ifadəsi
Report Settings' accepted_mime_types_json - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
multipleyes_no · Standart: false- Nümunə dəyəri
yes - Nümunə Bubble ifadəsi
Report Settings' allow_multiple_attachments - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
copy_to_cacheyes_no · Standart: true- Nümunə dəyəri
yes - Nümunə Bubble ifadəsi
Report Settings' copy_to_cache - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
max_filesnumber · Standart: 20- Nümunə dəyəri
5 - Nümunə Bubble ifadəsi
Report Settings' attachment_limit - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
max_file_bytesnumber · Standart: 268435456- Nümunə dəyəri
10485760 - Nümunə Bubble ifadəsi
Report Settings' max_attachment_bytes - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
is_activeyes_no · Standart: true- Nümunə dəyəri
yes - Nümunə Bubble ifadəsi
GuideHost's view_is_active (your yes/no custom state) - Bu görünüş açıq olduqda yes (bəli) təyin edin. Çıxarkən no (xeyr) təyin edin ki, oynatma və ya cari iş dayana bilsin.
disabledyes_no · Standart: false- Nümunə dəyəri
no - Nümunə Bubble ifadəsi
GuideHost's is_busy (your yes/no custom state) - Tətbiqiniz məşğul olduğu və ya bu əməliyyat mövcud olmadığı müddətcə elementi deaktiv edin.
show_controlsyes_no · Standart: true- Nümunə dəyəri
yes - Nümunə Bubble ifadəsi
App Settings' show_editor_controls - Daxili idarəetmələri göstərin və ya gizlədin.
languagetext · Standart: "auto"- Nümunə dəyəri
uk - Nümunə Bubble ifadəsi
Current User's preferred_language - language=auto‑i dəstəklənən cihaz və ya brauzer dilini izləmək üçün təyin edin. Açıq şəkildə seçmək üçün dəstəklənən dil kodunu daxil edin.
ui_text_jsontext · Standart: ""- Nümunə dəyəri
{} - Nümunə Bubble ifadəsi
App Settings' player_labels_json (supported keys only) - İstəyə bağlı JSON dəstəklənən düymə etiketləri ilə. Daxili mətn istifadə etmək üçün boş buraxın.
titletext · Standart: ""- Nümunə dəyəri
Lesson 4 — review - Nümunə Bubble ifadəsi
Selected Lesson's name - Tətbiqdə görünən mətn; boş buraxıldıqda, dəstəklənən yerlərdə daxili lokallaşdırılmış mətn istifadə olunur. Giriş üçün məxfi məlumat daxil etməyin.
Əməliyyatlar və onların girişləri · 10
Pick files
Heç bir əməliyyat parametri yoxdur
Load local source
source_uritext · Standart: —- Nümunə dəyəri
file:///app-cache/report.pdf - Nümunə Bubble ifadəsi
Photo Editor's output_uri - Bu cihazda oxuna bilən fayl yeri, seçiciniz və ya başqa bir plugin tərəfindən qaytarılır.
display_nametext · Standart: —- Nümunə dəyəri
report-photo.jpg - Nümunə Bubble ifadəsi
Selected Attachment's display_name - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
mime_typetext · Standart: —- Nümunə dəyəri
image/jpeg - Nümunə Bubble ifadəsi
Photo Editor's output_mime - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
Select picked file
indexnumber · Standart: —- Nümunə dəyəri
0 - Nümunə Bubble ifadəsi
Selected row's current_source_index - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
Save selection locally
Heç bir əməliyyat parametri yoxdur
List saved files
Heç bir əməliyyat parametri yoxdur
Restore saved file
file_idtext · Standart: —- Nümunə dəyəri
<returned saved file ID> - Nümunə Bubble ifadəsi
Selected LocalAttachment's local_file_id - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
Delete saved copy
file_idtext · Standart: —- Nümunə dəyəri
<returned saved file ID> - Nümunə Bubble ifadəsi
Selected LocalAttachment's local_file_id - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
confirmyes_no · Standart: —- Nümunə dəyəri
yes — explicit confirmation only - Nümunə Bubble ifadəsi
Confirm Checkbox is checked - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
Share selected file
dialog_titletext · Standart: —- Nümunə dəyəri
Share attachment - Nümunə Bubble ifadəsi
Selected Report's share_title - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
utitext · Standart: —- Nümunə dəyəri
"" - Nümunə Bubble ifadəsi
Empty unless your iOS integration supplies a proven UTI - Cari iş qeydi dəyərindən istifadə edin; onu aşağıdakı hədlərlə doğrulayın.
Cancel operation
Heç bir əməliyyat parametri yoxdur
Clear session
Heç bir əməliyyat parametri yoxdur
Vəziyyətlər və hadisələr
Vəziyyətlər
status · textBu əməliyyatın cari nəticəsi. Uğuru yadda saxlamaqdan əvvəl uyğun tamamlama hadisəsindən istifadə edin.
is_busy · yes_noİş hələ davam edir. Başqa bir əməliyyata başlamazdan əvvəl gözləyin.
native_pending · yes_noİş hələ davam edir. Başqa bir əməliyyata başlamazdan əvvəl gözləyin.
operation · textSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
selection_count · numberSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
selected_index · numberSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
file_id · textBu element və ya əmrin identifikatoru. Uyğun tətbiq qeydi ilə saxlayın. Qeyri‑müəyyən nəticəni təkrar cəhd edərkən eyni sorğu identifikatorundan istifadə edin.
local_uri · textBu cihazda faylın yerləşməsi. Fayl onlayn saxlanmalı olsa, ayrı-ayrılıqda yaddaşda saxlayın və ya yükləyin.
display_name · textSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
mime_type · textSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
mime_source · textSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
size_bytes · numberSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
is_saved_locally · yes_noSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
file_ids · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
file_uris · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
file_names · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
file_mime_types · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
file_sizes · number (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
files_json · textSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
saved_count · numberSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
saved_file_ids · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
saved_file_uris · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
saved_file_names · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
saved_file_mime_types · text (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
saved_file_sizes · number (siyahı)Seçilmiş fayllar üçün siyahı. Digər fayl siyahılarında eyni indeksdəki elementlər eyni fayla istinad edir.
saved_files_json · textSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
invalid_saved_count · numberSeçilmiş elementin cari dəyəri. Əlaqəli hadisədən sonra oxuyun.
share_status · textBu əməliyyatın cari nəticəsi. Uğuru yadda saxlamaqdan əvvəl uyğun tamamlama hadisəsindən istifadə edin.
error_code · textSon əməliyyat üçün xəta məlumatı. Faydalı mesaj göstərin və müvafiq təkrar seçimini təklif edin.
Hadisələr
selection_changedBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
files_savedBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
list_loadedBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
file_restoredBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
file_deletedBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
share_sheet_closedBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
operation_cancelledBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
files_errorBu hadisə baş verdikdə, eyni elementdən əlaqəli vəziyyətləri oxuyun.
İnkişaf etdiricilərin verdiyi suallar
Paylaşma “göndərildi” deməkdir?
Xeyr. Əməliyyat sistemi burada faylın alıcıya uğurla çatdırıldığına dair etibarlı təsdiq vermir. “Paylaşma paneli bağlandı” göstərin.
Abunəlik necə işləyir?
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.
Əlaqəli bələdçilər
Kömək üçün, hansı plugin və cihazı istifadə etdiyinizi, cəhd etdiyiniz əməliyyatı və nə baş verdiyini bizə bildirin. Şəxsi məlumatları olmayan nümunə istifadə edin. Açarınızı və ya şəxsi fayllarınızı heç vaxt paylaşmayın.