گالری تصاویر
گالری تصاویر به عنوان یک مخزن متمرکز برای ذخیره و مدیریت تصاویر عمل میکند. این منبع مهمی برای بهبود جذابیت بصری و عملکرد ویجتها، داشبوردها، دستگاهها و پروفایلهای دارایی در یک برنامه موبایل به شمار میآید. کاربران میتوانند بهراحتی تصاویر را بارگذاری، سازماندهی و انتخاب کنند تا رابط کاربری و تجربه کاربری خود را شخصیسازی کنند و ظاهری یکپارچه و برندسازیشده در سراسر پلتفرم ایجاد کنند.
پیکربندی کَش
API تصاویر ما برای بهینهسازی فرایند کش، از ETagها استفاده میکند که با این کار تنها زمانی تصاویر مجدداً دانلود میشوند که تغییر کرده باشند، و این موجب صرفهجویی در پهنای باند میشود. بهطور پیشفرض، هدرهای Cache-Control اعمال نمیشود و کارایی ETagها بهطور کامل در این زمینه نقشآفرینی میکند. با این حال، امکان سفارشیسازی رفتار کش از طریق متغیرهای محیطی وجود دارد:
- CACHE_SPECS_IMAGE_ETAGS_TTL: مدت زمان اعتبار (TTL) کش ETag تصاویر، که مقدار پیشفرض آن 44640 دقیقه است. پس از اتمام این زمان، کش حذف خواهد شد؛
- CACHE_SPECS_IMAGE_ETAGS_MAX_SIZE: حداکثر اندازه کش به واحد بایت. اگر این مقدار 0 باشد، کش غیرفعال است؛
- CACHE_SPECS_IMAGE_SYSTEM_BROWSER_TTL: مدت زمان اعتبار کش مرورگر برای تصاویر سیستمی، که بهصورت پیشفرض 0 دقیقه و غیرفعال است؛
- CACHE_SPECS_IMAGE_TENANT_BROWSER_TTL: مدت زمان اعتبار کش مرورگر برای تصاویر مستاجر، که بهصورت پیشفرض 0 دقیقه و غیرفعال است.
این تنظیمات مدت زمان نگهداری (TTL) تصاویر سیستمی و مستاجر در کش مرورگر کاربران را تعیین میکنند. افزایش TTL منجر به بهبود سرعت بارگذاری در بازدیدهای مجدد و کاهش بار سرور خواهد شد، در حالی که کاهش TTL امکان ارائه بهروزرسانیهای سریعتر محتوا را فراهم میکند. توصیه میشود تنظیمات TTL را بر اساس فرکانس بهروزرسانی تصاویر خود تنظیم کنید. جهت اطلاع از نحوه تغییر این تنظیمات، به مستندات مرتبط مراجعه کنید.
علاوه بر این، مدیر سیستم میتواند با پیکربندی پروفایلهای مستاجر، محدودیتهایی را در خصوص حداکثر اندازه هر تصویر و همچنین حجم کل تصاویر اعمال نماید. این مقادیر بهصورت بایت تعریف میشوند.
افزودن تصویر
شما میتوانید تصاویر خود را در فرمتهای رایج تصویری مانند PNG، JPEG، GIF و یا در فرمت فایل JSON به گالری تصاویر اضافه کنید.
بارگذاری تصویر
برای بارگذاری یک تصویر جدید در فرمت تصویری، مراحل زیر را دنبال کنید.
- به صفحه "گالری تصاویر" در بخش "منابع" بروید و سپس دکمه "بارگذاری تصویر" را که در گوشه سمت راست بالای صفحه قرار دارد، فشار دهید؛
- در پنجره "بارگذاری تصویر"، تصویر موردنظر خود را انتخاب یا درگ کنید و سپس روی دکمه "بارگذاری" کلیک کنید؛
- تصویر با موفقیت بارگذاری شد.
وارد کردن تصویر از JSON
برای وارد کردن تصاویر خود در فرمت فایل JSON، مراحل زیر را انجام دهید:
- به بخش "گالری تصاویر" در قسمت "منابع" مراجعه کنید و سپس روی آیکون "وارد کردن تصویر" که در قسمت بالای صفحه و سمت راست قرار دارد، کلیک کنید؛
- در پنجره "وارد کردن تصویر"، فایل JSON تصویر را بارگذاری کرده و گزینه "وارد کردن" را انتخاب کنید؛
- تصویر با موفقیت وارد شد.
تصاویر سیستمی
گالری تصاویر شامل مجموعهای از تصاویر سیستمی میباشد که میتوانید از آنها در طراحی داشبوردها، ویجتها و دیگر اجزای سیستم استفاده کنید. بهصورت پیشفرض، تنها تصاویر شخصی شما در لیست تصاویر قابل مشاهده هستند. برای نمایش همزمان تصاویر خود و تصاویر سیستمی، گزینه "فعالسازی تصاویر سیستمی" را فعال نمایید.
تغییر حالت نمایش تصاویر
برای مشاهده تصاویر میتوانید از دو حالت لیست یا شبکه استفاده کنید. جهت تغییر حالت نمایش، کافی است حالت دلخواه را از قسمت بالا و سمت چپ پنجره گالری تصاویر انتخاب نمایید.
عملیات روی تصاویر
قابلیتهایی مانند دانلود، صادر کردن به فرمت JSON، ویرایش، جاسازی و حذف تصاویر از طریق آیکونهای مربوط به هر تصویر در دسترس هستند. هر یک از این عملیات به شرح زیر است:
دانلود تصویر
برای دانلود تصویر در قالب فایل تصویری، بسته به حالت نمایشی انتخابشده:
- در حالت نمایش لیست، روی آیکون "دانلود تصویر" که کنار نام تصویر قرار دارد، کلیک کنید.
- در حالت نمایش شبکهای، نشانگر ماوس را روی تصویر موردنظر قرار داده و سپس آیکون "دانلود تصویر" را انتخاب کنید.
تصویر بهصورت فایل تصویری در رایانه شما ذخیره خواهد شد.
خروجی تصویر به فرمت JSON
برای خروجی گرفتن تصویر به فرمت JSON، بسته به حالت نمایشی انتخابشده برای تصاویر، میتوانید از دو روش زیر استفاده کنید:
- در حالت نمایش لیست، روی آیکون "صادر کردن تصویر به JSON" که کنار نام تصویر قرار دارد، کلیک کنید.
- در حالت نمایش شبکهای، نشانگر ماوس را روی تصویر موردنظر قرار داده و سپس آیکون "صادر کردن تصویر به JSON" را انتخاب کنید.
تصویر بهصورت فایل JSON در رایانه شما ذخیره خواهد شد.
Title text example
پس از اضافه کردن یک تصویر به گالری تصاویر، امکان جاسازی آن در ویجتهای کارت HTML، بخش HTML در ویرایشگر ویجت، توابع محتوای سلولی، اقدامات سفارشی و سایر قسمتهای مبتنی بر HTML فراهم میشود.
تصاویر ارائهشده در سطح سیستم برای تمامی کاربران پلتفرم قابل دسترسی هستند، اما تصاویر مستأجر تنها ممکن است برای مستأجران خاص در دسترس باشند. هر تصویر در پلتفرم ThingsConnect یک URL منحصربهفرد دارد که امکان دانلود آن را با یا بدون احراز هویت فراهم میکند.
با استفاده از قطعه کد زیر، میتوانید تصاویر را در بخشهایی که بر اساس HTML ساده عمل میکنند و نیازی به احراز هویت ندارند، جاسازی کنید. به عنوان مثال، در ویجتهای کارت HTML، توابع محتوای سلولی و غیره.
<img decoding="async" src="relative link to the image" alt="text description of the image" />
برای جاسازی تصویر در قالب HTML مبتنی بر Angular، مثلاً در ویجت کارت Markdown/HTML یا بخش HTML ویرایشگر ویجت، میتوانید از قطعه کد زیر استفاده نمایید:
<img [src]="'image URL' | image | async" />
این روش بهطور خودکار هدرهای احراز هویت را به درخواست تصویر اضافه میکند، که این امکان را فراهم میسازد تا یک URL تصویر برای کاربران مختلف تصاویر متفاوتی بازگرداند.
برای دریافت لینک تصویر جهت جاسازی آن، مراحل زیر را انجام دهید:
- به بخش "گالری تصاویر" در قسمت "منابع" مراجعه کنید؛
روی گزینه "جاسازی تصویر" مربوط به تصویری که میخواهید - جاسازی کنید، کلیک کنید (در حالت نمایش شبکهای، نشانگر ماوس خود را روی تصویر نگه دارید و سپس آیکون "جاسازی تصویر" را انتخاب کنید)؛
- قطعه کد مناسب برای قالب HTML مبتنی بر Angular یا اجزای مبتنی بر HTML ساده را انتخاب کرده و لینک منحصربهفرد آن تصویر را کپی کنید.
ویرایش تصویر
برای باز کردن پنجره ویرایش تصویر، بر روی آیکون "ویرایش تصویر" که در کنار نام تصویری که میخواهید ویرایش کنید، کلیک کنید (در حالت نمایش شبکهای، نشانگر ماوس خود را بر روی تصویر موردنظر قرار دهید و سپس بر روی آیکون "ویرایش تصویر" کلیک کنید). پنجره ویرایش باز خواهد شد، جایی که میتوانید نام تصویر را تغییر دهید، آن را دانلود کنید، به فرمت JSON صادر کنید، جاسازی کنید و همچنین تصویر را بهروزرسانی نمایید.
برای تغییر نام تصویر، نام جدید را وارد کرده و سپس بر روی آیکون "ذخیره" در پنجره "ویرایش تصویر" کلیک کنید.
بهروزرسانی تصویر
بهروزرسانی تصویر میتواند در مواردی مفید باشد، مثلاً زمانی که یک تصویر بهعنوان پسزمینه برای چندین داشبورد عمل میکند. این امکان را به شما میدهد که تنها یک بار تغییرات را اعمال کنید و تمام داشبوردهایی که از آن تصویر استفاده میکنند، بهطور خودکار نسخه بهروزرسانیشده را دریافت نمایند، که در نتیجه نیاز به ویرایش جداگانه هر داشبورد را از بین میبرد.
برای بهروزرسانی تصویر، بر روی دکمه "بهروزرسانی تصویر" در پنجره ویرایش کلیک کنید. تصویر جدیدی را انتخاب کرده یا به سادگی آن را به پنجره "بهروزرسانی تصویر" بکشید و بر روی "بهروزرسانی" کلیک کنید.
حذف تصویر
برای حذف یک تصویر از لیست تصاویر، مراحل زیر را انجام دهید:
بر روی آیکون "حذف تصویر" که در مقابل نام تصویری که میخواهید حذف کنید، کلیک کنید؛
در کادر تأیید، حذف تصویر را تأیید نمایید.
برای حذف یک تصویر که در حالت گرید نمایش داده شده است، مراحل زیر را انجام دهید:
- نشانگر ماوس خود را بر روی تصویر موردنظر نگه دارید و بر روی آیکون "حذف تصویر" کلیک کنید؛
- در کادر تأیید، حذف تصویر را تأیید نمایید.
شما میتوانید چندین تصویر (تنها از طریق نمای لیست تصاویر) را بهصورت همزمان حذف کنید:
- یک یا چند تصویر را که قصد حذف آنها را دارید، علامتگذاری کنید؛
بر روی آیکون سطل زباله "حذف" در گوشه بالا سمت راست کلیک کنید؛ - در کادر تأیید، حذف تصاویر را تأیید نمایید.
گامهای بعدی
- راهنمای آغازین - این راهنماها یک نمای کلی سریع از ویژگیهای اصلی ThingsConnect ارائه میدهند و برای تکمیل آنها تنها 15 تا 30 دقیقه زمان نیاز است.
- اتصال دستگاه خود - بیاموزید که چگونه دستگاهها را بر اساس فناوری یا راهحل ارتباطی خود متصل کنید.
- تصویرسازی دادهها - این راهنماها شامل دستورالعملهایی برای پیکربندی داشبوردهای پیچیده ThingsConnect هستند.
- پردازش و اقدامات داده - بیاموزید که چگونه از موتور قوانین ThingsConnect بهرهبرداری کنید.
- تحلیل دادههای IoT - بیاموزید که چگونه از موتور قوانین برای انجام وظایف تحلیلی پایه استفاده نمایید.
- نمونههای سختافزاری - بیاموزید که چگونه پلتفرمهای سختافزاری مختلف را به ThingsConnect متصل کنید.
- مشارکت و توسعه - با مشارکت و توسعه در ThingsConnect آشنا شوید.