مقدمه
این راهنما شما را از راههای مختلفی راهنمایی میکند که راهحل داستانسرایی سهبعدی را میتوان سفارشی کرد و به شما امکان میدهد داستانهای موقعیت جغرافیایی جذابی ایجاد کنید.
شما این قابلیت را دارید که راه حل داستان سرایی آنها را از طریق دو روش راحت پیکربندی کنید. اول، شما می توانید از رابط کاربری بصری موجود در برنامه Admin استفاده کنید که دارای یک پنل پیکربندی اختصاصی است. در این پانل، کاربران می توانند ویژگی های اصلی مانند imageUrl، عنوان، تاریخ و موارد دیگر را هم برای داستان کلی و هم برای فصل های جداگانه تغییر دهند.
دوم، میتوانید تنظیمات دوربین و گزینههای فوکوس را برای هر فصل با استفاده از رابط کاربری گرافیکی در برنامه Admin تنظیم کنید. هنگامی که کاربران از پیکربندی خود راضی بودند، این گزینه را دارند که فایل JSON تولید شده را دانلود کنند.
همچنین، میتوانید مستقیماً فایل JSON را ویرایش کنید. شما می توانید ساختار JSON را تنظیم کنید، راه حل داستان سرایی پیکربندی شده را بارگیری کنید، و کنترل پنل مدیریت را دور بزنید. این رویکرد دوگانه هم یک رابط کاربر پسند و هم دستکاری پیشرفته JSON را ارائه می دهد.
شروع به کار:
فعال کردن
داستان خود را بسازید
طرح کلی داستان به یک داستان جلد و سپس فصل تقسیم می شود. هر دو جلد و فصل را می توان به صورت جداگانه سفارشی کرد. بررسی کنید
جزئیات نحوه ساخت و سفارشی کردن داستان ها با استفاده از برنامه Admin و همچنین فایل پیکربندی.
صفحه جلد
اولین کاری که باید انجام دهید این است که یک صفحه جلد برای داستان کلی خود ایجاد کنید. این یک نمای کلی، یک عکس روی جلد و توضیحات را به استوری شما اضافه می کند.
از اپلیکیشن Admin استفاده کنید
شما با اضافه کردن یک صفحه جلد برای داستان خود شروع می کنید. این کار را از برنامه Admin با استفاده از صفحه زیر انجام می دهید:
از config.json استفاده کنید
علاوه بر این، اگر فایل پیکربندی را دارید، می توانید مستقیماً این بخش ها را در فایل اضافه کنید:
- 1.
imageUrl
: URL فایل رسانه اصلی (تصویر، گیف، یا ویدیو) برای کل داستان.
این میتواند هر URL قابل دسترسی عمومی باشد که به تصویر، گیف یا فایل ویدیویی اشاره میکند که میخواهید به عنوان رسانه اصلی برای کل داستان استفاده کنید.
- 2.
title
: عنوان کل داستان. - 3.
date
: تاریخ یا بازه زمانی مرتبط با داستان. - 4.
description
: شرح مختصری از داستان. - 5.
createdBy
: خالق یا نویسنده داستان. - 6.
imageCredit
: اعتبار تصویر اصلی. - 7.
cameraOptions
: تنظیمات اولیه دوربین برای کل داستان.
فصل ها
داستان به فصل هایی تقسیم می شود که هر فصل دارای مجموعه ای از متغیرهای خاص خود است. می توانید هر تعداد فصل که دوست دارید ایجاد کنید. شما با انتخاب یک آدرس شروع کنید و سپس جزئیات زیر را به فصل اضافه کنید.
از اپلیکیشن Admin استفاده کنید
جستجوی مکان : از نوار جستجوی تکمیل خودکار پلتفرم Google Maps یکپارچه برای پیدا کردن مکانی که میخواهید نشان دهید استفاده کنید.
هنگامی که یک مکان اضافه شد، می توانید با کلیک بر روی دکمه ویرایش در کنار مکان، جزئیات را به فصل اضافه کنید:
جزئیات مربوط به مکان را اضافه کنید:
هنگامی که از پیکربندی کلی راضی بودید، فایل json را دانلود کنید و می توانید از آن در برنامه آزمایشی استفاده کنید.
با استفاده از config.json پیکربندی کنید
میتوانید متغیرهای زیر را مستقیماً در فایل config.json دانلود شده ویرایش کنید تا هر فصل را سفارشی کنید:
-
title
: عنوان فصل. -
id
: شناسه منحصر به فرد برای فصل. -
imageUrl
: URL تصویر فصل. -
imageCredit
: اعتبار تصویر فصل. -
content
: محتوای متنی برای فصل. -
dateTime
: تاریخ یا بازه زمانی خاص فصل. -
coords
: مختصات مکان مرتبط با فصل.-
lat
: عرض جغرافیایی. -
lng
: طول جغرافیایی.
-
-
address
: آدرس مربوط به فصل.
تنظیمات دوربین
این برنامه کنترل های مختلفی را روی دوربین ارائه می دهد. این بخش شما را با تنظیمات مختلف دوربین و نحوه سفارشی کردن آنها آشنا می کند.
(پان، زوم، دوربین را کج کنید تا زاویه دید عالی خود را بدست آورید)
از اپلیکیشن Admin استفاده کنید
دوربین: سرعت حرکت دوربین و نوع مدار را برای ایجاد تجربه مشاهده انتخابی تنظیم کنید.
نشانگر موقعیت مکانی به شما امکان می دهد بین نمایش پین در یک مکان خاص یا پنهان کردن آن جابه جا شوید.
فوکوس شعاع بدون مشخص کردن مکان خاصی، سایهای در اطراف یک منطقه خاص ایجاد میکند. این برای نمایش یک محله یا منطقه عمومی عالی است.
این نشان می دهد که چگونه می توان فوکوس دوربین را برای نمایش یک منطقه به جای یک نقطه خاص تغییر داد.
از config.json استفاده کنید
همچنین می توانید تمام پارامترهای دوربین را مستقیماً با استفاده از فایل پیکربندی json سفارشی کنید:
cameraOptions
: تنظیمات دوربین برای فصل. (در مورد زوایای دوربین بیشتر بدانید)position
: پارامتر موقعیت مختصات فضایی دوربین را در محیط سه بعدی تعیین می کند. از سه مقدار x، y و z تشکیل شده است. هر مختصات نشان دهنده یک نقطه در محورهای x، y و z است که موقعیت دوربین را مشخص می کند.heading
: پارامتر عنوان به جهت افقی اشاره دارد که دوربین در آن قرار گرفته است. از نظر جغرافیایی، زاویه بین دید دوربین و جهت شمال را نشان می دهد. عنوان 0 نشان می دهد که دوربین به سمت شمال است.pitch
: پارامتر pitch زاویه عمودی دوربین را تعیین می کند. این نشان دهنده شیب یا شیب دید دوربین است. گام مثبت رو به پایین به نظر می رسد، در حالی که گام منفی به سمت بالا است.roll
: پارامتر roll چرخش حول محور دوربین را مشخص می کند. این حرکت چرخشی دوربین را نشان می دهد. یک رول 0 نشان دهنده عدم چرخش است، در حالی که مقادیر مثبت یا منفی به ترتیب نشان دهنده چرخش به سمت راست یا چپ هستند.
focusOptions
: گزینه هایی برای تمرکز روی یک نقطه خاص.focusRadius
: شعاع برای تمرکز.showFocus
: Boolean برای نشان دادن یا پنهان کردن فوکوس.showLocationMarker
: بولی برای نمایش یا پنهان کردن نشانگر مکان.
پیکربندی خود را ذخیره کنید
در آخر، روی ذخیره موقعیت دوربین کلیک کنید تا موقعیت دوربین شما ذخیره شود، سپس روی خروج از حالت ویرایش کلیک کنید تا کارتان ذخیره شود
این برنامه یک رابط کاربر پسند ارائه می دهد که به شما امکان می دهد تجربه سه بعدی را سفارشی کنید. این برنامه Admin است.
آخرین config.json
فایل config.json نهایی حاوی تمام اطلاعات مورد نیاز برای ایجاد تجربه داستان سرایی سفارشی شما است. این شامل جزئیات صفحه جلد، فصلها و تنظیمات دوربین است. شما می توانید از این فایل برای تنظیم دقیق داستان خود استفاده کنید و مطمئن شوید که دقیقاً همانطور که می خواهید به نظر می رسد و احساس می شود.
برای شروع، فایل config.json را از برنامه Admin دانلود کنید یا یک فایل جدید از ابتدا ایجاد کنید. سپس، فایل را در یک ویرایشگر متن باز کنید و شروع به ویرایش مقادیر کنید. می توانید متن، تصاویر و حتی تنظیمات دوربین را تغییر دهید تا تجربه ای منحصر به فرد و همه جانبه برای مخاطبان خود ایجاد کنید.
فایل json نمای کلی داستان می تواند به شکل زیر باشد:
{
"properties": {
"imageUrl": "https://storage.googleapis.com/gmp-3d-tiles-storytelling/assets/images/317-300x160.jpg",
"title": "Title",
"date": "1967",
"description": ""his is where you put descriptions",
"createdBy": "Add author",
"imageCredit": "Add image credit",
"cameraOptions": {
"position": {
"x": -2708127.031960028,
"y": -4260747.583520751,
"z": 3886346.825328216
},
"heading": -1.5708,
"pitch": -0.785398,
"roll": 0
}
}
و یک فصل خاص می تواند شبیه این باشد. Chapters یک آرایه است و می تواند چندین فصل جداگانه را در داخل آرایه قرار دهد.
"chapters": [
{
"title": "The Jimmy Hendrix Experience",
"id": 4,
"imageUrl": "https://storage.googleapis.com/gmp-3d-tiles-storytelling/assets/images/401-300x160.jpg",
"imageCredit": "Hunter",
"content": "XYZZZ",
"dateTime": "Aug 10-12 1967",
"coords": {
"lat": 37.7749,
"lng": -122.4194
},
"address": "The Filmore | 1805 Geary Blvd",
"cameraOptions": {
"position": {
"x": -2706472.5713478313,
"y": -4261528.277488908,
"z": 3885143.750529967
},
"heading": 0,
"pitch": 0,
"roll": 0
},
"focusOptions": {
"focusRadius": 3000,
"showFocus": false,
"showLocationMarker": true
}
},
سفارشی سازی های پیشرفته
شما می توانید در کد فرو بروید و می توانید چندین سفارشی سازی دیگر را انجام دهید:
فایل پیکربندی را از مکان دیگری بارگیری کنید
در خارج از جعبه، راه حل پیکربندی داستان سرایی را از یک فایل محلی بارگیری می کند. با این حال، این را می توان به راحتی در config.js تغییر داد:
export async function loadConfig(configUrl) {
try {
// Fetch the configuration data from the specified URL.
const configResponse = await fetch(configUrl);
تنظیمات دوربین
دوربین را می توان از فایل /utils/cesium.js
بیشتر سفارشی کرد. تعدادی متغیر مهم مانند:
- شعاع
- BASE_PITCH_RADIANS
- BASE_HEADING_RADIANS
- BASE_ROLL_RADIANS
- DEFAULT_HIGHLIGHT_RADIUS
به راحتی می توانید این متغیرها را تغییر دهید تا به فرشتگان دوربین و تجربیات مختلف دست پیدا کنید.
نتیجه گیری
در این سند راهنمای شخصی سازی اپلیکیشن داستان گویی سه بعدی را ارائه کرده ایم. ما گزینه های مختلف موجود در برنامه Admin و نحوه استفاده از آنها برای ایجاد داستان های موقعیت جغرافیایی همهجانبه و جذاب را بررسی کرده ایم. همچنین در مورد فرآیند ایجاد یک داستان سفارشی با استفاده از فایل config.json بحث کرده ایم. مراحل بعدی
اکنون که نحوه سفارشی سازی برنامه داستان سرایی سه بعدی را آموختید، می توانید شروع به ایجاد داستان های خود کنید. در اینجا چند ایده برای شروع شما وجود دارد:
- یک داستان در مورد زادگاه خود یا مکانی که بازدید کرده اید ایجاد کنید.
- داستانی در مورد یک رویداد تاریخی یا شخصی که از شما الهام گرفته است بسازید.
- داستانی درباره دنیای خیالی یا رویایی که دیده اید بسازید.
امکانات بی پایان هستند! بنابراین اجازه دهید تخیل خود را اجرا کند و چیزی واقعا خاص خلق کنید.
،مقدمه
این راهنما شما را از راههای مختلفی راهنمایی میکند که راهحل داستانسرایی سهبعدی را میتوان سفارشی کرد و به شما امکان میدهد داستانهای موقعیت جغرافیایی جذابی ایجاد کنید.
شما این قابلیت را دارید که راه حل داستان سرایی آنها را از طریق دو روش راحت پیکربندی کنید. اول، شما می توانید از رابط کاربری بصری موجود در برنامه Admin استفاده کنید که دارای یک پنل پیکربندی اختصاصی است. در این پانل، کاربران می توانند ویژگی های اصلی مانند imageUrl، عنوان، تاریخ و موارد دیگر را هم برای داستان کلی و هم برای فصل های جداگانه تغییر دهند.
دوم، میتوانید تنظیمات دوربین و گزینههای فوکوس را برای هر فصل با استفاده از رابط کاربری گرافیکی در برنامه Admin تنظیم کنید. هنگامی که کاربران از پیکربندی خود راضی بودند، این گزینه را دارند که فایل JSON تولید شده را دانلود کنند.
همچنین، میتوانید مستقیماً فایل JSON را ویرایش کنید. شما می توانید ساختار JSON را تنظیم کنید، راه حل داستان سرایی پیکربندی شده را بارگیری کنید، و کنترل پنل مدیریت را دور بزنید. این رویکرد دوگانه هم یک رابط کاربر پسند و هم دستکاری پیشرفته JSON را ارائه می دهد.
شروع به کار:
فعال کردن
داستان خود را بسازید
طرح کلی داستان به یک داستان جلد و سپس فصل تقسیم می شود. هر دو جلد و فصل را می توان به صورت جداگانه سفارشی کرد. بررسی کنید
جزئیات نحوه ساخت و سفارشی کردن داستان ها با استفاده از برنامه Admin و همچنین فایل پیکربندی.
صفحه جلد
اولین کاری که باید انجام دهید این است که یک صفحه جلد برای داستان کلی خود ایجاد کنید. این یک نمای کلی، یک عکس روی جلد و توضیحات را به استوری شما اضافه می کند.
از اپلیکیشن Admin استفاده کنید
شما با اضافه کردن یک صفحه جلد برای داستان خود شروع می کنید. این کار را از برنامه Admin با استفاده از صفحه زیر انجام می دهید:
از config.json استفاده کنید
علاوه بر این، اگر فایل پیکربندی را دارید، می توانید مستقیماً این بخش ها را در فایل اضافه کنید:
- 1.
imageUrl
: URL فایل رسانه اصلی (تصویر، گیف، یا ویدیو) برای کل داستان.
این میتواند هر URL قابل دسترسی عمومی باشد که به تصویر، گیف یا فایل ویدیویی اشاره میکند که میخواهید به عنوان رسانه اصلی برای کل داستان استفاده کنید.
- 2.
title
: عنوان کل داستان. - 3.
date
: تاریخ یا بازه زمانی مرتبط با داستان. - 4.
description
: شرح مختصری از داستان. - 5.
createdBy
: خالق یا نویسنده داستان. - 6.
imageCredit
: اعتبار تصویر اصلی. - 7.
cameraOptions
: تنظیمات اولیه دوربین برای کل داستان.
فصل ها
داستان به فصل هایی تقسیم می شود که هر فصل دارای مجموعه ای از متغیرهای خاص خود است. می توانید هر تعداد فصل که دوست دارید ایجاد کنید. شما با انتخاب یک آدرس شروع کنید و سپس جزئیات زیر را به فصل اضافه کنید.
از اپلیکیشن Admin استفاده کنید
جستجوی مکان : از نوار جستجوی تکمیل خودکار پلتفرم Google Maps یکپارچه برای پیدا کردن مکانی که میخواهید نشان دهید استفاده کنید.
هنگامی که یک مکان اضافه شد، می توانید با کلیک بر روی دکمه ویرایش در کنار مکان، جزئیات را به فصل اضافه کنید:
جزئیات مربوط به مکان را اضافه کنید:
هنگامی که از پیکربندی کلی راضی بودید، فایل json را دانلود کنید و می توانید از آن در برنامه آزمایشی استفاده کنید.
با استفاده از config.json پیکربندی کنید
میتوانید متغیرهای زیر را مستقیماً در فایل config.json دانلود شده ویرایش کنید تا هر فصل را سفارشی کنید:
-
title
: عنوان فصل. -
id
: شناسه منحصر به فرد برای فصل. -
imageUrl
: URL تصویر فصل. -
imageCredit
: اعتبار تصویر فصل. -
content
: محتوای متنی برای فصل. -
dateTime
: تاریخ یا بازه زمانی خاص فصل. -
coords
: مختصات مکان مرتبط با فصل.-
lat
: عرض جغرافیایی. -
lng
: طول جغرافیایی.
-
-
address
: آدرس مربوط به فصل.
تنظیمات دوربین
این برنامه کنترل های مختلفی را روی دوربین ارائه می دهد. این بخش شما را با تنظیمات مختلف دوربین و نحوه سفارشی کردن آنها آشنا می کند.
(پان، زوم، دوربین را کج کنید تا زاویه دید عالی خود را بدست آورید)
از اپلیکیشن Admin استفاده کنید
دوربین: سرعت حرکت دوربین و نوع مدار را برای ایجاد تجربه مشاهده انتخابی تنظیم کنید.
نشانگر موقعیت مکانی به شما امکان می دهد بین نمایش پین در یک مکان خاص یا پنهان کردن آن جابه جا شوید.
فوکوس شعاع بدون مشخص کردن مکان خاصی، سایهای در اطراف یک منطقه خاص ایجاد میکند. این برای نمایش یک محله یا منطقه عمومی عالی است.
این نشان می دهد که چگونه می توان فوکوس دوربین را برای نمایش یک منطقه به جای یک نقطه خاص تغییر داد.
از config.json استفاده کنید
همچنین می توانید تمام پارامترهای دوربین را مستقیماً با استفاده از فایل پیکربندی json سفارشی کنید:
cameraOptions
: تنظیمات دوربین برای فصل. (در مورد زوایای دوربین بیشتر بدانید)position
: پارامتر موقعیت مختصات فضایی دوربین را در محیط سه بعدی تعیین می کند. از سه مقدار x، y و z تشکیل شده است. هر مختصات نشان دهنده یک نقطه در محورهای x، y و z است که موقعیت دوربین را مشخص می کند.heading
: پارامتر عنوان به جهت افقی اشاره دارد که دوربین در آن قرار گرفته است. از نظر جغرافیایی، زاویه بین دید دوربین و جهت شمال را نشان می دهد. عنوان 0 نشان می دهد که دوربین به سمت شمال است.pitch
: پارامتر pitch زاویه عمودی دوربین را تعیین می کند. این نشان دهنده شیب یا شیب دید دوربین است. گام مثبت رو به پایین به نظر می رسد، در حالی که گام منفی به سمت بالا است.roll
: پارامتر roll چرخش حول محور دوربین را مشخص می کند. این حرکت چرخشی دوربین را نشان می دهد. یک رول 0 نشان دهنده عدم چرخش است، در حالی که مقادیر مثبت یا منفی به ترتیب نشان دهنده چرخش به سمت راست یا چپ هستند.
focusOptions
: گزینه هایی برای تمرکز روی یک نقطه خاص.focusRadius
: شعاع برای تمرکز.showFocus
: Boolean برای نشان دادن یا پنهان کردن فوکوس.showLocationMarker
: بولی برای نمایش یا پنهان کردن نشانگر مکان.
پیکربندی خود را ذخیره کنید
در آخر، روی ذخیره موقعیت دوربین کلیک کنید تا موقعیت دوربین شما ذخیره شود، سپس روی خروج از حالت ویرایش کلیک کنید تا کارتان ذخیره شود
این برنامه یک رابط کاربر پسند ارائه می دهد که به شما امکان می دهد تجربه سه بعدی را سفارشی کنید. این برنامه Admin است.
آخرین config.json
فایل config.json نهایی حاوی تمام اطلاعات مورد نیاز برای ایجاد تجربه داستان سرایی سفارشی شما است. این شامل جزئیات صفحه جلد، فصلها و تنظیمات دوربین است. شما می توانید از این فایل برای تنظیم دقیق داستان خود استفاده کنید و مطمئن شوید که دقیقاً همانطور که می خواهید به نظر می رسد و احساس می شود.
برای شروع، فایل config.json را از برنامه Admin دانلود کنید یا یک فایل جدید از ابتدا ایجاد کنید. سپس، فایل را در یک ویرایشگر متن باز کنید و شروع به ویرایش مقادیر کنید. می توانید متن، تصاویر و حتی تنظیمات دوربین را تغییر دهید تا تجربه ای منحصر به فرد و همه جانبه برای مخاطبان خود ایجاد کنید.
فایل json نمای کلی داستان می تواند به شکل زیر باشد:
{
"properties": {
"imageUrl": "https://storage.googleapis.com/gmp-3d-tiles-storytelling/assets/images/317-300x160.jpg",
"title": "Title",
"date": "1967",
"description": ""his is where you put descriptions",
"createdBy": "Add author",
"imageCredit": "Add image credit",
"cameraOptions": {
"position": {
"x": -2708127.031960028,
"y": -4260747.583520751,
"z": 3886346.825328216
},
"heading": -1.5708,
"pitch": -0.785398,
"roll": 0
}
}
و یک فصل خاص می تواند شبیه این باشد. Chapters یک آرایه است و می تواند چندین فصل جداگانه را در داخل آرایه قرار دهد.
"chapters": [
{
"title": "The Jimmy Hendrix Experience",
"id": 4,
"imageUrl": "https://storage.googleapis.com/gmp-3d-tiles-storytelling/assets/images/401-300x160.jpg",
"imageCredit": "Hunter",
"content": "XYZZZ",
"dateTime": "Aug 10-12 1967",
"coords": {
"lat": 37.7749,
"lng": -122.4194
},
"address": "The Filmore | 1805 Geary Blvd",
"cameraOptions": {
"position": {
"x": -2706472.5713478313,
"y": -4261528.277488908,
"z": 3885143.750529967
},
"heading": 0,
"pitch": 0,
"roll": 0
},
"focusOptions": {
"focusRadius": 3000,
"showFocus": false,
"showLocationMarker": true
}
},
سفارشی سازی های پیشرفته
شما می توانید در کد فرو بروید و می توانید چندین سفارشی سازی دیگر را انجام دهید:
فایل پیکربندی را از مکان دیگری بارگیری کنید
در خارج از جعبه، راه حل پیکربندی داستان سرایی را از یک فایل محلی بارگیری می کند. با این حال، این را می توان به راحتی در config.js تغییر داد:
export async function loadConfig(configUrl) {
try {
// Fetch the configuration data from the specified URL.
const configResponse = await fetch(configUrl);
تنظیمات دوربین
دوربین را می توان از فایل /utils/cesium.js
بیشتر سفارشی کرد. تعدادی متغیر مهم مانند:
- شعاع
- BASE_PITCH_RADIANS
- BASE_HEADING_RADIANS
- BASE_ROLL_RADIANS
- DEFAULT_HIGHLIGHT_RADIUS
به راحتی می توانید این متغیرها را تغییر دهید تا به فرشتگان دوربین و تجربیات مختلف دست پیدا کنید.
نتیجه گیری
در این سند راهنمای شخصی سازی اپلیکیشن داستان گویی سه بعدی را ارائه کرده ایم. ما گزینه های مختلف موجود در برنامه Admin و نحوه استفاده از آنها برای ایجاد داستان های موقعیت جغرافیایی همهجانبه و جذاب را بررسی کرده ایم. همچنین در مورد فرآیند ایجاد یک داستان سفارشی با استفاده از فایل config.json بحث کرده ایم. مراحل بعدی
اکنون که نحوه سفارشی سازی برنامه داستان سرایی سه بعدی را آموختید، می توانید شروع به ایجاد داستان های خود کنید. در اینجا چند ایده برای شروع شما وجود دارد:
- یک داستان در مورد زادگاه خود یا مکانی که بازدید کرده اید ایجاد کنید.
- داستانی در مورد یک رویداد تاریخی یا شخصی که از شما الهام گرفته است بسازید.
- داستانی درباره دنیای خیالی یا رویایی که دیده اید بسازید.
امکانات بی پایان هستند! بنابراین اجازه دهید تخیل خود را اجرا کند و چیزی واقعا خاص خلق کنید.