سرد القصص الثلاثي الأبعاد: دليل التخصيص

مقدمة

سيرشدك هذا الدليل إلى الطرق المختلفة التي يمكن بها تخصيص حلّ "سرد القصص الثلاثي الأبعاد"، ما يتيح لك إنشاء قصص جذابة عن الموقع الجغرافي.

يمكنك ضبط حلّ سرد القصص من خلال طريقتَين مناسبتَين. أولاً، يمكنك استخدام واجهة المستخدم البديهية المتوفّرة في تطبيق "المشرف"، والتي تتضمّن لوحة إعدادات مخصّصة. ضمن هذه اللوحة، يمكن للمستخدمين تعديل السمات الرئيسية، مثل imageUrl والعنوان والتاريخ وغير ذلك، سواء للقصة العامة أو للفصول الفردية.

ثانيًا، يمكنك ضبط إعدادات الكاميرا وخيارات التركيز لكل فصل باستخدام واجهة المستخدم الرسومية في تطبيق "المشرف". وبعد أن يصبح المستخدمون راضين عن الإعدادات، يمكنهم تنزيل ملف JSON الذي تم إنشاؤه.

بدلاً من ذلك، يمكنك تعديل ملف JSON مباشرةً. يمكنك ضبط بنية JSON وتحميل حل سرد القصص الذي تم إعداده وتجاوز لوحة تحكم المشرف. يقدّم هذا النهج المزدوج كلاً من واجهة سهلة الاستخدام وإمكانية إجراء عمليات متقدمة على ملف JSON.

بدء الاستخدام:

استخدام تطبيق 3D Storytelling Admin المستضاف

أو

الحصول على مفتاح واجهة برمجة التطبيقات ونزِّل الرمز من GitHub.

تفعيل

• واجهة برمجة التطبيقات للصور الواقعية ثلاثية الأبعاد في شكل مربّعات
• Places API

إنشاء قصتك الخاصة

يتم تقسيم التنسيق العام للقصة إلى قصة رئيسية يتبعها فصول. ويمكن تخصيص كلّ من الغلاف والفصل بشكل فردي. اطّلِع على
تفاصيل حول كيفية إنشاء القصص وتخصيصها باستخدام كلّ من تطبيق "المشرف" وملف الإعدادات.

صفحة الغلاف

أول شيء عليك القيام به هو إنشاء صفحة غلاف لقصتك الشاملة. يؤدي ذلك إلى إضافة النظرة العامة وصورة الغلاف والوصف إلى قصتك.

استخدام تطبيق "المشرف"

ابدأ بإضافة صفحة غلاف لقصتك. يمكنك إجراء ذلك من تطبيق "المشرف" باستخدام الشاشة التالية:

استخدام 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:

• cameraOptions: إعدادات الكاميرا لهذا الفصل (مزيد من المعلومات حول زوايا الكاميرا)

  • position: تحدِّد مَعلمة الموضع الإحداثيات المكانية للكاميرا في البيئة الثلاثية الأبعاد. يتكون من ثلاث قيم: x وy وz. يمثّل كل إحداثي نقطة في محاور x وy وz، ما يحدّد موقع الكاميرا.

  • ‫heading: تشير مَعلمة الاتجاه إلى الاتجاه الأفقي الذي يتم توجيه الكاميرا إليه. من الناحية الجغرافية، تمثل الزاوية بين زاوية رؤية الكاميرا والاتجاه الشمالي. يشير الاتجاه 0 إلى أنّ الكاميرا تشير إلى الشمال.

  • pitch: تحدّد مَعلمة درجة الصوت الزاوية العمودية للكاميرا. ويشير إلى إمالة العرض أو ميله في الكاميرا. تشير الدرجة المتصاعدة إلى الأسفل، بينما تشير الدرجة المتنازلية إلى الأعلى.

  • ‫roll: تحدِّد مَعلمة 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
      }
    },

تخصيصات متقدّمة

يمكنك الاطّلاع على الرمز وإجراء العديد من عمليات التخصيص الأخرى:

تحميل ملف الإعداد من موقع آخر

يُحمِّل الحلّ تلقائيًا إعدادات سرد القصص من ملف محلي . ومع ذلك، يمكن تغيير ذلك بسهولة في 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

لا تتردد في تعديل هذه المتغيّرات للحصول على زوايا وتجارب مختلفة للكاميرا.

الخاتمة

في هذه المستندات، قدّمنا دليلاً لتخصيص تطبيق سرد القصص المجسمة. لقد استكشَفنا الخيارات المختلفة المتاحة في تطبيق "المشرف" وexaminedكيفية استخدامها لإنشاء قصص مواقع جغرافية غامرة وتفاعلية. لقد discussed ا أيضًا عملية إنشاء قصة مخصّصة باستخدام ملف config.json. الخطوات التالية

بعد أن تعرّفت على كيفية تخصيص تطبيق "رواية القصص الثلاثية الأبعاد"، يمكنك البدء في إنشاء قصصك الخاصة. إليك بعض الأفكار للبدء:

• أنشئ قصة عن مدينتك أو مكان زرته.
• يمكنك إنشاء قصة عن حدث تاريخي أو عن شخص ألهمك بأفكارك.
• أنشئ قصة عن عالم خيالي أو حلم حلمت به.

الخيارات لا تحصى. لذلك، أطلِق العنان لخيالك وأنشئ محتوى فريدًا.