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

مقدمة

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

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

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

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

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

تفعيل

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

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

صفحة الغلاف

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

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

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

الصورة

استخدام ملف 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. الخطوات التالية

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

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

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