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

مقدمة

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

لديك المرونة لتكوين حل سرد القصص من خلال طريقتين مناسبتين. في الإصدار الجديد، يمكنك استخدام واجهة المستخدم البسيطة المتوفرة في تطبيق المشرف، والتي تضم لوحة تهيئة مخصصة. ضمن هذه اللوحة، يمكن للمستخدمين تعديل الخصائص الرئيسية مثل عنوان URL للصورة والعنوان والتاريخ وغيرها، وذلك لكل من المقالة الشاملة والفصول الفردية.

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

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

الخطوات الأولى:

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

أو

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

تفعيل

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

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

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

صفحة الغلاف

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

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

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

استخدام ملف 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: تحدّد معلَمة الدوران الدوران حول محور الكاميرا. وهو يمثّل حركة التواء الكاميرا. تشير اللفة 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

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

الخلاصة

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

بعد أن تعلمت كيفية تخصيص تطبيق 3D Storytelling، يمكنك البدء في إنشاء قصصك الخاصة. إليك بعض الأفكار للبدء:

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

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