Xodera Plugins · Bubble Native
Xodera B2 Files Native
پیوست‌های برنامه را در ذخیره‌سازی Backblaze B2 خود نگه دارید. به کاربران مجاز اجازه بارگذاری، مرور و دانلود فایل‌ها را بدهید و به‌صورت صریح انتخاب کنید که چه زمانی یک فایل می‌تواند به‌صورت عمومی به اشتراک گذاشته شود.
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
مثال‌های عملی
یک پیوست کار را در سطل خصوصی خود توسعه‌دهنده ذخیره کنید
یک کار Bubble به یک مرجع ذخیره‌سازی پایدار نیاز دارد بدون اینکه URL دانلود منقضی‌شده را به عنوان هویت فایل در نظر بگیرد.
`bucket_binding_id = an allowed binding to your own private bucket`؛ `local_uri` پویا، `display_name`، `mime_type` و `expected_size` فایل محلی انتخاب‌شده را توصیف می‌کنند.
برنامهریزیشده: Check local source → Upload file → انتظار برای `upload_verified`. سپس جریان کاری شما `asset_ref` و فراداده‌ها را در رکورد کار متعلق ذخیره میکند.
از `asset_ref`، `size_bytes`، `mime_type` و `upload_status` استفاده کنید. بعداً، Resolve private read می‌تواند URL موقت برای استفاده مجاز فراهم کند.
اگر ذخیره‌سازی پایگاه‌داده پس از `upload_verified` شکست بخورد، به‌روزرسانی DB را با همان مرجع دارایی به جای بارگذاری دیگر دوباره امتحان کنید. نتیجه `upload_pending` را با استفاده از Check or recover upload status و همان شناسه بارگذاری بررسی کنید.
برنامهریزیشده. حساب B2 شما هزینه‌های ذخیره‌سازی و دانلود را پرداخت میکند.
یک گالری پیوست مالکیت‌شده با رکوردهای فایل پایدار بسازید
یک گالری فایل به نام‌ها، نوع‌ها و صفحه‌بندی و همچنین روشی برای باز کردن دارایی انتخاب‌شده در آینده نیاز دارد.
رکورد File برنامه شما پس از بارگذاری تأییدشده، `asset_ref` پذیرفته‌شده، نام نمایشی، MIME و رابطه مالک/کار را ذخیره میکند؛ از URI محلی به عنوان هویت ابری آن استفاده نکنید.
برنامهریزیشده: از List my B2 files برای ساخت لیست پیوست‌ها استفاده کنید. asset_refs فایل‌ها را شناسایی میکند؛ مقادیر در همان ایندکس نام‌ها و نوع‌های آنها را فراهم می‌کنند. انتخاب یک فایل asset_ref آن را به Get asset metadata یا Download accepted version منتقل میکند.
`has_more` و `next_cursor` به پرس‌وجوی فعلی تعلق دارند. یک دانلود کامل `local_output_uri` را برمی‌گرداند؛ این یک کپی محلی دستگاه است، نه یک لینک عمومی دائمی.
پس از تغییرات binding/حساب/پرس‌وجو، صفحه‌بندی را بازنشانی کنید. در `transfer_error`، File Thing موجود را حفظ کنید و `error_code` را نشان دهید؛ آن را به‌صورت ساکت با نسخه دیگری از ارائه‌دهنده جایگزین نکنید.
برنامهریزیشده. حساب B2 شما هزینه‌های ذخیره‌سازی و دانلود را پرداخت میکند.
انتشار و حذف نسخه دقیق را به‌صورت عمدی انجام دهید
کارکنان نباید به‌طور تصادفی یک پیوست خصوصی را فاش کنند یا تمام نسخه‌ها را هنگام جایگزینی یک تصویر حذف کنند.
`asset_ref = the selected accepted version`؛ binding سطل و مجوزهای فایل برنامه باید عملیات درخواست‌شده را مجاز کنند.
قابلیت مشاهده فعلی را نشان دهید، تأیید صریح بخواهید، سپس Change public sharing را انجام دهید. برای حذف، Delete accepted version را با تأیید فراخوانی کنید؛ متادیتای برنامه را تا زمان دانستن نتیجه تأیید شده نگه دارید.
پس از `share_changed`، `visibility` و `public_url` را فقط زمانی مصرف کنید که اشتراک‌گذاری عمومی صراحتاً مجاز بوده باشد. پس از `delete_completed`، رکورد File مالک را به‌روزرسانی کنید؛ `delete_pending` حذف نهایی نیست.
به‌جای فرض موفقیت، نتیجه یک عملیات نامطمئن را بررسی کنید. URLهای خواندن ارائه‌دهنده که قبلاً صادر شدهاند ممکن است تا تاریخ انقضا معتبر بمانند؛ حذف یک ردیف DB یا غیرفعال‌سازی اشتراک‌گذاری بایت‌های قبلاً دانلودشده را از دریافت‌کننده پس نمی‌گیرد.
برنامهریزیشده. حساب B2 شما هزینه‌های ذخیره‌سازی و دانلود را پرداخت میکند.
آنچه اکنون کار میکند
پلاگین برنامهریزیشده. هنوز نصب نشده یا برای استفاده در دسترس نیست. راهنمای زیر جریان کاری فایل موردنظر را نشان می‌دهد.
ساخت گردش‌کار
برنامهریزیشده
گردش کار برنامهریزیشده. هنوز در نسخه بتای فعلی در دسترس نیست.
این مثال‌ها از رکوردهای برنامهای مانند Lesson، Message و Order استفاده می‌کنند. آنها را با انواع داده و نام‌های عنصر خود جایگزین کنید. آدرس‌های رسانه‌ای نمونه باید با فایل‌های خود جایگزین شوند.
برنامهریزیشده: در تنظیمات پروژه خود، ذخیره‌سازی B2 و سطل مجاز را انتخاب کنید. حریم خصوصی، پیشوند پوشه و انواع و اندازه‌های فایل‌های پذیرفته‌شده را تنظیم کنید.
از List B2 bindings برای نمایش گزینه‌های ذخیره‌سازی مجاز استفاده کنید. از List my B2 files برای نمایش فایل‌های کاربر فعلی و از Get my B2 file info برای جزئیات استفاده کنید.
یک فایل انتخاب کنید. bucket_binding_id، local_uri، display_name، mime_type و expected_size را تنظیم کنید، سپس Upload file را اجرا کنید. پیشرفت را نشان دهید، اما قبل از در نظر گرفتن فایل بهعنوان ذخیره‌شده، منتظر upload_verified بمانید.
asset_ref را در رکورد برنامه خود ذخیره کنید. از آن برای Get asset metadata، Resolve private read یا Download accepted version استفاده کنید. Change public sharing و Delete accepted version نیاز به تأیید جداگانه دارند.
یک‌بار پیکربندی کنید
فعالسازی کلید برای این افزونه برنامه‌ریزی شده است. پروژهٔ برنامهٔ Bubble خود را در BestPlugins → Dashboard → Plugins ایجاد یا انتخاب کنید. Xodera B2 Files Native را انتخاب کنید، کلید آن را کپی کنید، سپس Bubble → Plugins → Xodera B2 Files Native را باز کنید و در project_api_key بچسبانید. یک‌بار ذخیره کنید؛ سپس از اقدامات زیر استفاده کنید. هر افزونه در هر پروژه کلید مخصوص به خود را دارد.
از حساب Backblaze B2 خود استفاده کنید و سطل (bucket) موردنظر برای این برنامه را انتخاب کنید. تصمیم بگیرید چه کسی می‌تواند فایل‌ها را بخواند و بارگذاری کند. نام‌های فیلدهای بله/خیر کاربر مرتبط را در b2_reader_permission_field و b2_writer_permission_field ذخیره کنید؛ پیش‌فرض‌ها b2_files_reader و b2_files_writer هستند. فقط یک مدیر مجاز باید این مجوزهای کاربری را تغییر دهد.
یک‌بار پیکربندی کنید
- پروژه برنامه Bubble خود را در BestPlugins → Dashboard → Plugins ایجاد یا انتخاب کنید.
- این افزونه را انتخاب کنید و کلید پروژه آن را کپی کنید.
- برنامهریزیشده: Bubble → Plugins → Xodera B2 Files Native را باز کنید؛ کلید را در project_api_key بچسبانید و ذخیره کنید.
- عنصر را اضافه کنید، داده‌های برنامه خود را انتخاب کنید و گردش کار زیر را بسازید.
- در حال حاضر دسترسی به بتای خصوصی فقط موجود است. نصب عمومی و فعالسازی پرداختی هنوز باز نیستند.
نصب و اشتراک
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.
نتیجه را در برنامه خود ذخیره کنید
پیوست مثال: asset_ref، گزارش/سفارش مرتبط، مالک، display_name، mime_type و size_bytes. پس از upload_verified این‌ها را ذخیره کنید. برای بازگشایی فایل بعداً از asset_ref استفاده کنید؛ یک آدرس خواندن موقت یا مسیر روی یک دستگاه، مرجع فایل دائمی نیست. اگر ذخیره‌سازی رکورد پایگاه داده شکست، به‌جای بارگذاری مجدد فایل، ذخیره‌سازی آن رکورد را دوباره تلاش کنید.
خطا، لغو و بازیابی
اگر نتیجه بارگذاری نامشخص باشد، upload_id را نگه دارید و از Check or recover upload status استفاده کنید. به‌صورت خودکار نسخه دیگری بارگذاری نکنید. لغو بر انتقال ناتمام تأثیر می‌گذارد، نه بر فایل ذخیره‌شده. اگر دسترسی منقضی شد، به‌جای استفاده مجدد از آدرس موقت قدیمی، فایل را دوباره درخواست کنید.
قابلیت‌ها و محدودیت‌ها
حداکثر حجم فایل برنامهریزیشده: 256 MiB، یا محدودیت سطل پایین‌تری که انتخاب می‌کنید. هزینه‌های ذخیره‌سازی و دانلود Backblaze به حساب B2 شما تعلق دارد. فایل‌ها در سطل عمومی حتی وقتی رکورد برنامه مرتبط خصوصی باشد، عمومی هستند. هیچ تعهدی برای اسکن ویروس، بارگذاری چندبخشی، توقف یا بازیابی پس از خاتمه برنامه وجود ندارد.
تنظیمات، اقدامات و نتایج
از این نام‌ها در Bubble استفاده کنید. ویژگی‌های برنامهریزیشده به‌صورت جداگانه علامت‌گذاری شدهاند.
تنظیمات بتای موجود
تنظیمات عنصر
bucket_binding_id · textlocal_uri · textdisplay_name · textmime_type · textexpected_size · numbermetadata_json · textasset_ref · textis_active · yes_nodisabled · yes_nolanguage · textui_text_json · texttitle · textshow_preview · yes_noshow_provider_browse · yes_noوضعیت‌ها
status · textis_busy · yes_noupload_id · textupload_status · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numberbytes_sent · numberprogress · numberprogress_indeterminate · yes_notemporary_read_url · textread_expires_at · textlocal_output_uri · textpublic_url · textvisibility · textnext_cursor · texthas_more · yes_noquery_revision · textfiles_json · textbuckets_json · textremote_files_json · textremote_next_cursor · textremote_has_more · yes_noremote_query_revision · textbucket_binding_id · textcleanup_pending · yes_noerror_code · texterror_message · textرویدادها
file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_clearedاقدامات و ورودی‌های آنها
List allowed bucketsSelect bucket bindingCheck local sourceUpload fileCheck or recover upload statusCancel owned transferClear local sessionList application filesRefresh application filesLoad more application filesSelect asset referenceGet asset metadataResolve private readDownload accepted versionBrowse provider filesChange public sharingDelete accepted versionتنظیمات عنصر · 14
گردش کار برنامهریزیشده. هنوز در نسخه بتای فعلی در دسترس نیست.
bucket_binding_idtext · پیش‌فرض: ""- مقدار مثال
<binding returned by List B2 bindings> - مثال Bubble عبارت
Selected Binding's binding_id - انتخاب ذخیره‌سازی توسط List B2 bindings بازگردانده شد. شناسه آن را برای این فایل استفاده کنید.
local_uritext · پیش‌فرض: ""- مقدار مثال
file:///app-cache/attachment.jpg - مثال Bubble عبارت
Offline Files' local_uri - محل قابل خواندن فایل در این دستگاه. این یک لینک دانلود آنلاین نیست.
display_nametext · پیش‌فرض: ""- مقدار مثال
report-photo.jpg - مثال Bubble عبارت
Selected Attachment's display_name - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
mime_typetext · پیش‌فرض: ""- مقدار مثال
image/jpeg - مثال Bubble عبارت
Photo Editor's output_mime - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
expected_sizenumber · پیش‌فرض: 0- مقدار مثال
246975 - مثال Bubble عبارت
Offline Files' size_bytes - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
metadata_jsontext · پیش‌فرض: ""- مقدار مثال
{"label":"field-report"} - مثال Bubble عبارت
Selected Attachment's safe_metadata_json - JSON اختیاری با اطلاعات برنامه مانند برچسب گزارش. آن را کوچک نگه دارید و از داده‌های شخصی خودداری کنید.
asset_reftext · پیش‌فرض: ""- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
is_activeyes_no · پیش‌فرض: true- مقدار مثال
yes - مثال Bubble عبارت
GuideHost's view_is_active (your yes/no custom state) - در حالی که این نما باز است، مقدار را به بله تنظیم کنید. هنگام خروج، به نه تنظیم کنید تا پخش یا کار جاری متوقف شود.
disabledyes_no · پیش‌فرض: false- مقدار مثال
no - مثال Bubble عبارت
GuideHost's is_busy (your yes/no custom state) - عنصر را غیرفعال کنید وقتی برنامه شما مشغول است یا این عمل در دسترس نیست.
languagetext · پیش‌فرض: "auto"- مقدار مثال
uk - مثال Bubble عبارت
Current User's preferred_language - language=auto را تنظیم کنید تا زبان دستگاه یا مرورگر پشتیبانی‌شده را دنبال کند. برای انتخاب صریح، کد زبان پشتیبانی‌شده را وارد کنید.
ui_text_jsontext · پیش‌فرض: ""- مقدار مثال
{} - مثال Bubble عبارت
App Settings' player_labels_json (supported keys only) - JSON اختیاری با برچسب‌های دکمه پشتیبانی‌شده. برای استفاده از متن داخلی خالی بگذارید.
titletext · پیش‌فرض: ""- مقدار مثال
Lesson 4 — review - مثال Bubble عبارت
Selected Lesson's name - متن قابل مشاهده برنامه؛ خالی بودن از نسخه بومی‌سازی‌شده داخلی استفاده میکند در صورت پشتیبانی. بدون اعتبارنامه.
show_previewyes_no · پیش‌فرض: false- مقدار مثال
yes - مثال Bubble عبارت
App Settings' b2_preview - نمایش یا مخفی‌سازی پیش‌نمایش فایل.
show_provider_browseyes_no · پیش‌فرض: false- مقدار مثال
no - مثال Bubble عبارت
Current User's authorized_browse_UI (presentation only) - نمایش یا مخفی‌سازی کنترل‌های مرور ذخیره‌سازی برای کاربران مجاز.
اقدامات و ورودی‌های آنها · 20
گردش کار برنامهریزیشده. هنوز در نسخه بتای فعلی در دسترس نیست.
List allowed buckets
پارامترهای اقدام وجود ندارد
Select bucket binding
binding_idtext · پیش‌فرض: —- مقدار مثال
<returned allowed binding ID> - مثال Bubble عبارت
Selected Binding's binding_id - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
Check local source
پارامترهای اقدام وجود ندارد
Upload file
acknowledge_public_bytesyes_no · پیش‌فرض: —- مقدار مثال
no - مثال Bubble عبارت
Public bucket disclosure Checkbox is checked (private bucket: no) - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
confirm_retryyes_no · پیش‌فرض: —- مقدار مثال
no - مثال Bubble عبارت
Retry Checkbox is checked after confirmed clean pending status - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
Check or recover upload status
upload_idtext · پیش‌فرض: —- مقدار مثال
<original returned upload_id> - مثال Bubble عبارت
Current UploadIntent's upload_id - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
Cancel owned transfer
پارامترهای اقدام وجود ندارد
Clear local session
پارامترهای اقدام وجود ندارد
List application files
پارامترهای اقدام وجود ندارد
Refresh application files
پارامترهای اقدام وجود ندارد
Load more application files
پارامترهای اقدام وجود ندارد
Select asset reference
asset_reftext · پیش‌فرض: —- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
Get asset metadata
asset_reftext · پیش‌فرض: —- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
Resolve private read
asset_reftext · پیش‌فرض: —- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
Download accepted version
asset_reftext · پیش‌فرض: —- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
Browse provider files
prefixtext · پیش‌فرض: —- مقدار مثال
"" - مثال Bubble عبارت
Authorized Browse Settings' prefix - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
load_moreyes_no · پیش‌فرض: —- مقدار مثال
no - مثال Bubble عبارت
Load More button only, for unchanged query - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
Change public sharing
asset_reftext · پیش‌فرض: —- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
enabledyes_no · پیش‌فرض: —- مقدار مثال
no - مثال Bubble عبارت
Public Share Checkbox is checked after separate confirmation - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
confirmyes_no · پیش‌فرض: —- مقدار مثال
yes — explicit confirmation only - مثال Bubble عبارت
Confirm Checkbox is checked - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
Delete accepted version
asset_reftext · پیش‌فرض: —- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
confirmyes_no · پیش‌فرض: —- مقدار مثال
yes — explicit confirmation only - مثال Bubble عبارت
Confirm Checkbox is checked - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
List B2 bindings
environmenttext · پیش‌فرض: —- مقدار مثال
development - مثال Bubble عبارت
App Settings' selected_environment - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
بازگشت‌ها
ok · yes/nostatus · texterror_code · textbinding_ids · text listlabels · text listprivacy · text listmax_size_bytes · number listList my B2 files
environmenttext · پیش‌فرض: —- مقدار مثال
development - مثال Bubble عبارت
App Settings' selected_environment - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
binding_idtext · پیش‌فرض: —- مقدار مثال
<returned allowed binding ID> - مثال Bubble عبارت
Selected Binding's binding_id - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
limitnumber · پیش‌فرض: —- مقدار مثال
50 - مثال Bubble عبارت
Gallery Settings' page_size - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
cursortext · پیش‌فرض: —- مقدار مثال
"" - مثال Bubble عبارت
Previous List my B2 files result's next_cursor; empty on first page - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
بازگشت‌ها
ok · yes/nostatus · texterror_code · textasset_refs · text listdisplay_names · text listmime_types · text listsize_bytes · number listcreated_ats · text listvisibility · text listpublic_urls · text listprovider_status · text listinspection_status · text listmetadata_labels · text listhas_more · yes/nonext_cursor · textquery_revision · textGet my B2 file info
environmenttext · پیش‌فرض: —- مقدار مثال
development - مثال Bubble عبارت
App Settings' selected_environment - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
binding_idtext · پیش‌فرض: —- مقدار مثال
<returned allowed binding ID> - مثال Bubble عبارت
Selected Binding's binding_id - از مقدار رکورد تجاری فعلی استفاده کنید؛ آن را نسبت به محدودیتهای زیر اعتبارسنجی کنید.
asset_reftext · پیش‌فرض: —- مقدار مثال
<returned asset_ref> - مثال Bubble عبارت
Selected B2Asset's asset_ref - هویت ثابت و مبهم دارایی پذیرفته‌شده از سرویس. انتخاب آن هرگز مجوز کاربر را دور نمی‌زند.
بازگشت‌ها
ok · yes/nostatus · texterror_code · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numbercreated_at · textvisibility · textpublic_url · textprovider_status · textinspection_status · textmetadata_label · textوضعیت‌ها و رویدادها
گردش کار برنامهریزیشده. هنوز در نسخه بتای فعلی در دسترس نیست.
وضعیت‌ها
status · textنتیجه فعلی این عمل. قبل از ذخیره موفقیت، از رویداد تکمیل مطابقت‌دار استفاده کنید.
is_busy · yes_noکار هنوز در حال انجام است. پیش از شروع عمل دیگری صبر کنید.
upload_id · textشناسه برای این مورد یا عمل. آن را همراه با رکورد برنامهٔ مرتبط نگه دارید. هنگام تلاش مجدد برای نتیجهٔ نامشخص، از همان شناسهٔ درخواست استفاده کنید.
upload_status · textنتیجه فعلی این عمل. قبل از ذخیره موفقیت، از رویداد تکمیل مطابقت‌دار استفاده کنید.
asset_ref · textشناسه برای این مورد یا عمل. آن را همراه با رکورد برنامهٔ مرتبط نگه دارید. هنگام تلاش مجدد برای نتیجهٔ نامشخص، از همان شناسهٔ درخواست استفاده کنید.
display_name · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
mime_type · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
size_bytes · numberمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
bytes_sent · numberمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
progress · numberمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
progress_indeterminate · yes_noمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
temporary_read_url · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
read_expires_at · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
local_output_uri · textموقعیت فایل روی این دستگاه. اگر باید آنلاین نگه داشته شود، فایل را جداگانه ذخیره یا بارگذاری کنید.
public_url · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
visibility · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
next_cursor · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
has_more · yes_noمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
query_revision · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
files_json · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
buckets_json · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
remote_files_json · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
remote_next_cursor · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
remote_has_more · yes_noمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
remote_query_revision · textمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
bucket_binding_id · textشناسه برای این مورد یا عمل. آن را همراه با رکورد برنامهٔ مرتبط نگه دارید. هنگام تلاش مجدد برای نتیجهٔ نامشخص، از همان شناسهٔ درخواست استفاده کنید.
cleanup_pending · yes_noمقدار فعلی مورد انتخاب‌شده. پس از رویداد مرتبط آن را بخوانید.
error_code · textاطلاعات خطا برای آخرین عمل. پیام مفید نشان دهید و گزینهٔ تلاش مجدد مرتبط را ارائه دهید.
error_message · textاطلاعات خطا برای آخرین عمل. پیام مفید نشان دهید و گزینهٔ تلاش مجدد مرتبط را ارائه دهید.
رویدادها
file_selectedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
upload_startedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
upload_transport_completedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
upload_verifiedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
upload_pendingهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
buckets_loadedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
bucket_selectedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
list_loadedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
metadata_loadedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
read_resolvedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
download_completedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
share_changedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
delete_completedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
delete_pendingهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
browse_loadedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
transfer_cancelledهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
cleanup_pendingهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
transfer_errorهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
session_clearedهنگامی که این رویداد رخ می‌دهد، وضعیت‌های مرتبط را از همان عنصر بخوانید.
سؤالاتی که توسعه‌دهندگان می‌پرسند
آیا میتوانم URL خواندن موقت را بهعنوان فایل خود ذخیره کنم؟
خیر. asset_ref و متادیتای استاندارد را حفظ کنید. دسترسیهای خواندن را مجدداً مجاز کنید؛ مسیر دانلود دستگاه یک فایل Bubble نیست.
اشتراک چگونه کار میکند؟
قیمتگذاری برنامهریزیشده: نصب افزونه در Bubble رایگان است. دسترسی به BestPlugins یک اشتراک جداگانه برای هر افزونه در هر پروژه برنامهای Bubble است: 7 روز رایگان، سپس US$1.50 در ماه. Development و Live گنجانده شدهاند. محدودیت ثابت برای تعداد عملیات وجود ندارد؛ محدودیتهای حجم فایل و ویژگیها همچنان اعمال میشوند. پرداخت هنوز باز نیست. صفحه فعالسازی تاریخ اولین صورتحساب و شرایط لغو را نشان خواهد داد.
راهنماهای مرتبط
Marketplace انتشار در انتظار
راهنمای انجمن منتشر نشده است
برای دریافت کمک، به ما بگویید از کدام افزونه و دستگاه استفاده می‌کنید، عملی که امتحان کردید و چه اتفاقی افتاد. از مثالی بدون داده‌های شخصی استفاده کنید. هرگز کلید یا فایل‌های خصوصی خود را به اشتراک نگذارید.