מבוא
המדריך הזה כולל דרכים שונות שבהן פתרון מספרי הסיפורים בתלת-ממד יכול להיות מותאם אישית, וכך ליצור סיפורים מרתקים של מיקום גיאוגרפי.
יש לכם את הגמישות להגדיר את פתרון הסיפור שלהם באמצעות שני שיטות נוחות. אשוח, אתה יכול להשתמש בממשק המשתמש האינטואיטיבי הזמין אפליקציית ניהול עם חלונית הגדרות ייעודית. בחלונית הזו, המשתמשים יכולים לשנות את המאפיינים הראשיים, כמו imageUrl, title, תאריך ועוד, גם לסיפור הכולל וגם לפרקים בודדים.
בשלב השני, אפשר לכוונן את הגדרות המצלמה ואת אפשרויות המיקוד לכל אחד מהם פרק באמצעות ממשק GUI באפליקציית Admin. אחרי שהם מרוצים מההגדרות, המשתמשים יכולים להוריד את קובץ ה-JSON שנוצר.
לחלופין, אפשר לערוך ישירות את קובץ ה-JSON. אפשר לשנות את המבנה של JSON, לטעון את הפתרון שנוצר לסיפורים אישיים, ועוקפים את לוח הבקרה של האדמין. הגישה הכפולה הזאת מציעה גם ממשק ידידותי למשתמש ועיבוד מתקדם של JSON.
תחילת העבודה:
הפעלה
יוצרים סיפור משלכם
הפריסה הכוללת של הסיפור מחולקת לסיפור שער ואחריו פרקים.
אתם יכולים להתאים אישית את הכריכה ואת הפרק בנפרד. צ'ק-אאוט
פרטים על האופן שבו ניתן ליצור את הסטוריז ולהתאים אותם אישית באמצעות אפליקציית Admin
וגם את קובץ התצורה.
דף הכריכה
הדבר הראשון שצריך לעשות הוא ליצור דף שער עבור כל מסיפורים. הפעולה הזו מוסיפה את הסקירה הכללית, את תמונת השער והתיאור לסטורי.
שימוש באפליקציית הניהול
כדי להתחיל, צריך להוסיף דף שער לסטורי שלכם. אפשר לעשות את זה דרך אפליקציית Admin. באמצעות המסך הבא:
שימוש ב-config.json
בנוסף, אם יש לכם קובץ תצורה, תוכלו להוסיף את הקטעים האלה ישירות הקובץ:
- 1.
imageUrl
: כתובת ה-URL של קובץ המדיה הראשי (תמונה, קובץ GIF או סרטון) את כל הסיפור.
זו יכולה להיות כל כתובת URL שנגישה לכולם ומפנה לתמונה, לקובץ GIF או לסרטון שרוצים להשתמש בו כמדיה הראשית עבור כל הכתבה.
- 2.
title
: הכותרת של הכתבה המלאה. - 3.
date
: התאריך או מסגרת הזמן שמשויכים לסטורי. - 4.
description
: תיאור קצר של הכתבה. - 5.
createdBy
: היוצר או המחבר של הסיפור. - 6.
imageCredit
: קרדיט על התמונה הראשית. - 7.
cameraOptions
: הגדרות מצלמה ראשוניות לכל הסטורי.
פרקים
הסיפור מחולק לפרקים, כאשר לכל אחד מהם קבוצת משתנים משלו. אפשר ליצור כמה פרקים שרוצים. מתחילים בבחירת כתובת ולאחר מכן מוסיפים את הפרטים הבאים אל פרק.
שימוש באפליקציית הניהול
חיפוש מיקום: שימוש בחיפוש ההשלמה האוטומטי בפלטפורמה של מפות Google כדי למצוא את המיקום שרוצים להציג.
לאחר הוספת מיקום ניתן להוסיף פרטים לפרק על ידי לחיצה על לחצן עריכה ליד המיקום:
מוסיפים פרטים על המיקום:
כשההגדרות האישיות מתאימות לכם, הורידו את קובץ ה-json ו אפשר להשתמש בה באפליקציית ההדגמה.
הגדרה באמצעות config.json
אפשר לערוך את המשתנים הבאים ישירות בקובץ config.json שהורדתם כדי להתאים אישית כל פרק:
title
: שם הפרק.id
: מזהה ייחודי של הפרק.imageUrl
: כתובת ה-URL של התמונה של הפרק.imageCredit
: קרדיט על תמונת הפרק.content
: תוכן הטקסט של הפרק.dateTime
: תאריך או מסגרת זמן ספציפיים לפרק.coords
: הקואורדינטות של המיקום שמשויך לפרק.lat
: קו רוחב.lng
: קו אורך.
address
: כתובת שקשורה לפרק.
הגדרות המצלמה
האפליקציה מספקת הרבה אמצעי בקרה שונים במצלמה. הקטע הזה יסביר לך על ההגדרות השונות של המצלמה ואיך להתאים אותן אישית.
(ניתן להזיז,לשנות את מרחק התצוגה, להטות את המצלמה כדי לקבל את זווית הצפייה המושלמת)
שימוש באפליקציית הניהול
מצלמה: כוונון מהירות וסוג המסלול של המצלמה כדי ליצור וחוויית הצפייה שנבחרה.
סמן מיקום מאפשר לעבור בין הצגת סיכה במיקום ספציפי את המיקום שלו או מסתיר אותו.
מיקוד הרדיוס יוצר צללית של דהייה מסביב לאזור ספציפי ללא במטרה לזהות מיקום ספציפי. זה נהדר להצגת שכונה או אזור כללי.
כאן רואים איך לשנות את מיקוד המצלמה כדי להציג אזור במקום לנקודה ספציפית.
שימוש ב-config.json
אפשר גם להתאים אישית את כל הפרמטרים של המצלמה ישירות באמצעות הגדרת JSON file:
cameraOptions
: הגדרות המצלמה לפרק. (מידע נוסף על המצלמה זוויות)position
: פרמטר המיקום קובע את הקואורדינטות המרחביות של בסביבה התלת-ממדית. הוא מורכב משלושה ערכים: x, y ו-z. כל קואורדינטה מייצגת נקודה בצירים ה-x, ה-y וה-z, המגדירה את מיקום המצלמה.heading
: פרמטר הכותרת מתייחס לכיוון האופקי ב- שאליו המצלמה מופנית. במונחים גיאוגרפיים, היא מייצגת את בין זווית הראייה של המצלמה לכיוון צפון. כותרת 0 מציין שהמצלמה פונה לכיוון צפון.pitch
: פרמטר גובה הצליל קובע את הזווית האנכית של מצלמה. הוא מציין את ההטיה או הנטייה של תצוגת המצלמה. א' צליל חיובי פונה כלפי מטה, ואילו גובה צליל שלילי מצביע למעלה.roll
: פרמטר הגליל מגדיר את הסיבוב סביב גבולות המצלמה לציר הזמן. הוא מייצג את התנועה המסתובבת של המצלמה. הטלה של 0 מציין שאין סיבוב, בעוד שערכים חיוביים או שליליים מציינים ימינה או שמאלה, בהתאמה.
focusOptions
: אפשרויות להתמקדות בנקודה ספציפית.focusRadius
: רדיוס למיקוד.showFocus
: ערך בוליאני להצגה או להסתרה של המיקוד.showLocationMarker
: ערך בוליאני להצגה או להסתרה של סמן המיקום.
שמירת ההגדרות האישיות
לסיום, לוחצים על שמירת מיקום המצלמה כדי לשמור את מיקום המצלמה, ואז לוחצים על יציאה ממצב עריכה כדי לשמור את העבודה.
האפליקציה הזו מספקת ממשק ידידותי למשתמש שמאפשר לבצע התאמה אישית בחוויית התלת-ממד. זאת אפליקציית הניהול.
קובץ config.json הסופי
קובץ config.json הסופי מכיל את כל המידע הנדרש ליצירת לספר סיפורים בהתאמה אישית. היא כוללת את הפרטים של דף השער, את הפרקים והגדרות המצלמה. אפשר להשתמש בקובץ הזה כדי לשפר את הסיפור ולוודא נראה ומרגיש בדיוק כמו שרציתם.
כדי להתחיל, צריך להוריד את הקובץ config.json מאפליקציית האדמין, או ליצור סרטון חדש מאפס. לאחר מכן, פותחים את הקובץ בכלי לעריכת טקסט ומתחילים עריכת הערכים. אפשר לשנות את הטקסט, התמונות ואפילו המצלמה כדי ליצור חוויה ייחודית וסוחפת לקהל.
קובץ 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": [
{
"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
}
},
התאמות אישיות מתקדמות
אפשר להתעמק בקוד ולבצע התאמות אישיות נוספות:
טעינת קובץ התצורה ממיקום אחר
הפתרון טוען את סיפור המותג מ-Google Ads. קובץ מקומי . עם זאת, אפשר לשנות את זה בקלות ב-config.js:
export async function loadConfig(configUrl) {
try {
// Fetch the configuration data from the specified URL.
const configResponse = await fetch(configUrl);
הגדרות המצלמה
אפשר להוסיף עוד אפשרויות להתאמה אישית של המצלמה מקובץ /utils/cesium.js
.
היא מגדירה כמה משתנים חשובים, כמו:
- RADIUS
- BASE_PITCH_RADIANS
- BASE_HEADING_RADIANS
- BASE_ROLL_RADIANS
- DEFAULT_HIGHLIGHT_RADIUS
אתם יכולים לשנות את המשתנים האלה כדי לקבל חוויות ומלאכים שונים של המצלמה.
סיכום
במסמכים האלה, סיפקנו מדריך להתאמה אישית של סיפורים בתלת-ממד תרגום מכונה. בדקנו את האפשרויות השונות שזמינות באפליקציית Admin איך אפשר להשתמש בהם כדי ליצור סיפורים סוחפים ומעניינים של מיקום גיאוגרפי. רביעי דיון גם בתהליך של יצירת סטורי בהתאמה אישית באמצעות הקובץ config.json חדש. השלבים הבאים
עכשיו, אחרי שלמדתם איך להתאים אישית את האפליקציה של בניית הסיפורים בתלת-ממד, יכולים להתחיל ליצור סיפורים משלכם. ריכזנו כאן כמה רעיונות שיעזרו לכם להתחיל:
- צור סיפור על עיר המגורים שלך או על מקום שביקרת בו.
- אפשר ליצור כתבה על אירוע היסטורי או על אדם שנותן לכם השראה.
- יוצרים סיפור על עולם בדיוני או על חלום שהיה לכם.
האפשרויות הן אינסופיות! אז תנו לדמיון להשתולל וליצור היא משהו מיוחד באמת.