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

مقدمة

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

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

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

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

البدء:

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

أو

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

تفعيل

• واجهة برمجة التطبيقات للصور الواقعية 3D tiles
• 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. الخطوات التالية

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

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

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