عمليات تخصيص أسلوب السرد ثلاثي الأبعاد

مقدمة

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

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

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

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

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

تفعيل

• واجهة برمجة التطبيقات لمربّعات ثلاثية الأبعاد لصور واقعية
• 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: تحدّد مَعلمة التمايل الدوران حول محور الكاميرا. وهي تمثّل حركة التواء الكاميرا. تشير القيمة 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. الخطوات التالية

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

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

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