تنزيل Android WebCast - تنزيل كود مصدر Android WebCast

Android WebCast

شفرة المصدر الأخرى

v05.01.00

تنزيل

بث ويب

تطبيق Android لاستخراج عناوين URL للفيديو (ملف/دفق) من مواقع الويب ومشاهدتها في مكان آخر (مشغل فيديو داخلي/خارجي، Google Chromecast، ExoAirPlayer).

لقطات الشاشة..

بث ويب

رحلة

يتم عرض BrowserActivity عند بدء تشغيل التطبيق، ويتضمن:
- متصفح ويب أساسي جدًا
  - شريط العناوين
  - WebView
- أيقونات شريط العمل:
  - تبديل الإشارة المرجعية
    - إضافة/إزالة عنوان URL لموقع الويب الحالي إلى/من قائمة الإشارات المرجعية المحفوظة باستمرار
- عناصر قائمة شريط الإجراءات:
  - الإشارات المرجعية
    - الدرج المفتوح على اليسار: الإشارات المرجعية
  - فيديوهات
    - الدرج المفتوح على اليمين: مقاطع الفيديو
  - إعدادات
    - افتح SettingsActivity
  - مخرج
    - أغلق كل واجهة المستخدم واخرج من التطبيق
- الدرج على اليسار: الإشارات المرجعية
  - يحتوي على قائمة مستمرة من:
    - عناوين URL لمواقع الويب التي تم حفظها عبر رمز تبديل الإشارة المرجعية
    - عناوين URL للفيديو التي تم حفظها عبر درج مقاطع الفيديو
  - انقر فوق عنصر قائمة من أجل:
    - افتح عنوان URL لموقع الويب في WebView
    - مشاهدة عنوان URL للفيديو
      - تحدد SettingsActivity الإجراء المعين المطلوب تنفيذه
  - انقر لفترة طويلة على عنصر القائمة من أجل:
    - إعادة تسمية
    - يمسح
- الدرج على اليمين: مقاطع الفيديو
  - يحتوي على قائمة مؤقتة بعناوين URL للفيديو التي تم العثور عليها على صفحة الويب التي تم تحميلها حاليًا في WebView
    - يتم مسح هذه القائمة في كل مرة ينتقل فيها WebView إلى صفحة ويب جديدة
  - انقر فوق عنصر قائمة من أجل:
    - أضف عنوان URL للفيديو إلى قائمة الإشارات المرجعية المحفوظة باستمرار
    - مشاهدة عنوان URL للفيديو
      - تحدد SettingsActivity الإجراء المعين المطلوب تنفيذه
  - انقر لفترة طويلة على عنصر القائمة من أجل:
    - يمسح
يبدأ SettingsActivity من قائمة شريط الإجراءات في BrowserActivity ، ويتضمن:
- مشغل فيديو لتحديد ما إذا كنت تريد مشاهدة مقاطع الفيديو باستخدام..
  - داخلي مع مرسل Chromecast
    - بدء VideoActivity
  - خارجي
    - ابدأ منتقي النشاط مع نية ضمنية
      - فعل
        android.intent.action.VIEW
      - بيانات
        عنوان URL للفيديو
      - يكتب
        نوع mime لتنسيق الفيديو
      - إضافات
        referUrl
        (سلسلة) عنوان URL المرجعي
        يستخدم من قبل ExoAirPlayer
  - مرسل ExoAirPlayer
    - بدء تشغيل ExoAirPlayerSenderActivity
  - تكوين وكيل HLS
    - ابدأ منتقي النشاط مع نية ضمنية
      - فعل
        android.intent.action.VIEW
      - بيانات
        http://webcast-reloaded.surge.sh/proxy.html#/watch/${base64_video}/referer/${base64_referer}
      - يكتب
        "نص/أتش تي أم أل"
    - بدء تشغيل HlsProxyConfigurationActivity
      - فقط عندما لا يكون هناك نشاط يحتوي على مرشح نوايا مطابق
        وهو ما لا ينبغي أن يحدث أبدًا، نظرًا لأن أي متصفح ويب قياسي يجب أن يعرض التعامل مع هذه النية
يتم تشغيل VideoActivity عند مشاهدة عنوان URL للفيديو باستخدام مشغل الفيديو الداخلي، ويتضمن:
- ExoPlayer
  - يعرض رمزًا في الركن الأيمن السفلي من شريط أدوات التحكم في الفيديو للتبديل بين تشغيل/إيقاف وضع ملء الشاشة
- مرسل Chromecast
  - يعرض رمز إرسال شريط الإجراءات عند اكتشاف Google Chromecast واحد على الأقل على الشبكة المحلية
  - عند الاتصال بجهاز Chromecast
    - يتم إرسال عناوين URL للفيديو إلى تطبيق جهاز الاستقبال الذي يعمل في Chromecast
    - يقوم تطبيق جهاز استقبال Chromecast بتحميل عنوان URL للفيديو في مشغل فيديو HTML5 مضمن
      - يتم نقل بيانات الفيديو مباشرة بين Chromecast والخادم الذي يستضيف عنوان URL للفيديو
      - لن يتم النقل بأي من الأحداث التالية:
        توقف VideoActivity
        توقف BrowserActivity
        تم الخروج من تطبيق WebCast
        تم إيقاف تشغيل جهاز Android
- قائمة عناوين URL للفيديو
  - انقر فوق عنصر قائمة من أجل:
    - تشغيل عنوان URL للفيديو
      - إذا كان متصلاً بجهاز Chromecast:
        على جهاز Chromecast
      - خلاف ذلك:
        على أندرويد، في ExoPlayer
        تتضمن كافة طلبات HTTP عنوان URL المرجعي
يبدأ ExoAirPlayerSenderActivity عند مشاهدة عنوان URL للفيديو باستخدام مرسل ExoAirPlayer، ويتضمن:
- WebView الذي يقوم بتحميل صفحة ويب واحدة
  - يعتمد عنوان URL لصفحة الويب على إصدار Android
    - أندرويد 5.0 وأحدث
      - الإصدار باستخدام ES6+ جافا سكريبت الحديثة
    - أندرويد 4.x والإصدارات الأقدم
      - الإصدار باستخدام جافا سكريبت المتوافقة مع ES5
  - تحتوي تجزئة عنوان URL على:
    - #/watch/${base64_video}/referer/${base64_referer}
- تقرأ صفحة الويب البيانات من تجزئة عنوان URL وتملأ الحقول مسبقًا:
  - رابط الفيديو
  - عنوان URL المرجعي
- تقرأ صفحة الويب البيانات من ملفات تعريف الارتباط وتملأ الحقول مسبقًا:
  - يستضيف
  - ميناء
  - https
- يوفر واجهة مستخدم أساسية للتحكم في أي تطبيق استقبال ExoAirPlayer يمكن الوصول إليه عبر الشبكة
يتم بدء تشغيل HlsProxyConfigurationActivity عند مشاهدة عنوان URL للفيديو باستخدام تكوين HLS-Proxy على جهاز بدون أي متصفح ويب متاح، ويتضمن:
- WebView الذي يقوم بتحميل صفحة ويب متوافقة مع ES5
  - تحتوي تجزئة عنوان URL على:
    - #/watch/${base64_video}/referer/${base64_referer}
- تقرأ صفحة الويب البيانات من تجزئة عنوان URL وتملأ الحقول مسبقًا:
  - رابط الفيديو
  - عنوان URL المرجعي
- تقرأ صفحة الويب البيانات من ملفات تعريف الارتباط وتملأ الحقول مسبقًا:
  - يستضيف
  - ميناء
  - https
- يؤدي النقر فوق الزر "تحميل المشغل" إلى تنفيذ المهام التالية:
  - يقوم بتكوين عنوان URL جديد للفيديو الذي يعيد توجيه بيان HLS من خلال HLS-Proxy
  - يعيد توجيه WebView إلى صفحة ويب أخرى متوافقة مع ES5 والتي توفر وجهات نقطة نهاية اختيارية لبيان HLS الوكيل
    - صفحة ويب ES6 لمرسل ExoAirPlayer
    - صفحة ويب ES5 لمرسل Chromecast
      - في WebView على نظام التشغيل Android 4.x والإصدارات الأقدم:
        وظيفة مشغل الفيديو لا تعمل
      - في WebView على نظام التشغيل Android 5.0 والإصدارات الأحدث:
        تعمل وظيفة مشغل الفيديو
        وظيفة إرسال Chromecast لا تعمل

تحذيرات مهمة

قد يتم تشغيل بعض عناوين URL للفيديو في WebCast وExoAirPlayer، ولكن لا يمكن تشغيلها على Chromecast أو مشغلات الفيديو الخارجية الأخرى
- يمكن أن يحدث هذا عندما تتم استضافة عنوان URL للفيديو بواسطة خادم يستخدم رأس طلب Referer HTTP لتقييد الوصول، وهي استراتيجية شائعة
  - يتمتع كل من WebCast وExoAirPlayer بوظيفة تكوين قيمة هذا الرأس لكل عنوان URL فريد للفيديو
  - لا يمكن لتطبيقات جهاز استقبال Chromecast تغيير قيمة هذا الرأس لأنها مقيدة بسياسات أمان المتصفح القياسية
    - تمنع مواصفات XHR والجلب تغيير بعض رؤوس طلبات HTTP، بما في ذلك Referer
    - تطبيق استقبال WebCast Chromecast
      - يحاول تغيير قيمة هذا الرأس
      - يكشف في وحدة تحكم مصحح الأخطاء عن بعد أن هذه المحاولة تثير التحذير:
        تم رفض تعيين "المرجع" للرأس غير الآمن
  - ستحتاج مشغلات الفيديو الخارجية الأخرى إلى:
    - اقرأ referUrl الإضافي في نية البداية
    - قم بتكوين مكتبة عميل HTTP الخاصة بها لتغيير قيمة هذا الرأس
  - يوفر HLS-Proxy حلاً مناسبًا للأغراض العامة
    - الإعداد للتكامل مع WebCast:
      1. قم بتثبيت HLS-Proxy
        npm install --global "@warren-bank/hls-proxy"
      2. تثبيت ويب مونكي
        التطبيق لفتح تكوين HLS-Proxy
      3. في ويب مونكي
        تثبيت برنامج المستخدم WebCast-Reloaded
        يضيف وظائف محسنة إلى صفحة الويب المتوافقة مع ES5 والتي توفر تكوين HLS-Proxy
        تمكن زر المسمى: بدء التطبيق
        عند النقر:
        ابدأ منتقي النشاط مع نية ضمنية
        فعل
        android.intent.action.VIEW
        بيانات
        عنوان URL لبيان HLS الوكيل
        يكتب
        "التطبيق/x-mpegurl"
      4. في بث ويب
        الإعدادات > مشغل الفيديو > تكوين وكيل HLS
    - الاستخدام:
      1. قم بتشغيل HLS-Proxy
        hlsd --port 8080 --req-insecure --useragent "Chrome/90"
      2. في بث ويب
        انتقل إلى WebView الداخلي إلى صفحة تحتوي على دفق فيديو HLS المطلوب
        افتح درج مقاطع الفيديو (على اليمين)
        انقر على عنوان URL لدفق الفيديو HLS المطلوب
        انقر فوق: مشاهدة
        سيبدأ منتقي النشاط
        سيتم تضمين WebMonkey في قائمة التطبيقات التي تحتوي على نشاط مطابق
        انقر فوق: ويب مونكي
      3. في ويب مونكي
        قم بتكوين موقع مثيل HLS-Proxy قيد التشغيل:
        يستضيف
        ميناء
        https
        انقر فوق: بدء التطبيق
        سيبدأ منتقي النشاط
        سيتم تضمين WebCast في قائمة التطبيقات التي تحتوي على نشاط مطابق
        انقر فوق: مشغل فيديو WebCast
      4. في بث ويب
        انقر فوق رمز مرسل Chromecast لإرسال دفق فيديو HLS الوكيل إلى جهاز Chromecast
يعد مكون Android System WebView مسؤولاً بالكامل عن تجربة متصفح الويب
- هذا المكون له تاريخ معقد
- دون الدخول في التفاصيل:
  - على إصدارات أندرويد <5.0
    - يتم دمج مكون WebView في البرنامج الثابت
      - لا يمكن تحديثه
      - يقوم بتحميل صفحات الويب الحديثة بشكل سيئ، حيث تغيرت لغة جافا سكريبت (ES6+) ومواصفات html (HTML5) بشكل ملحوظ
  - على إصدارات أندرويد >= 5.0
    - مكون WebView هو تطبيق مستقل
      - يمكن تحديثها
  - على إصدارات أندرويد >= 7.0
    - يتم استبدال مكون WebView بمكون من متصفح الويب Google Chrome، عند تثبيته وتمكينه
      - يمكن تحديثها

تنظيم جيت ريبو

الفروع التي لا معنى لها
- 01-الأساس
  - مجموعة من التطبيقات الصغيرة لتطوير واختبار الميزات التجريبية
- 02-البث الشبكي-httpclient
  - استخدم مكتبة عميل HTTP خارجية: Apache HttpClient
  - استخدم رأس استجابة Content-Type لاكتشاف ملفات الفيديو
- 03-البث الشبكي-okhttp
  - استخدم مكتبة عميل HTTP خارجية: okhttp
  - استخدم رأس استجابة Content-Type لاكتشاف ملفات الفيديو
- 04-اسم ملف البث الشبكي
  - يستخدم WebView لتنزيل كافة طلبات HTTP
  - يستخدم التعبيرات العادية لاكتشاف امتدادات الملفات المرتبطة بتنسيقات الفيديو في طلبات URL
الفروع النشطة
- 05-البث الشبكي-اسم الملف-media3
  - يستخدم WebView لتنزيل جميع طلبات HTTP
  - يستخدم التعبيرات العادية لاكتشاف امتدادات الملفات المرتبطة بتنسيقات الفيديو في طلبات URL
  - يعتمد على فرع 04-webcast-filename، وينتقل من ExoPlayer إلى AndroidX Media3
- 00-تطبيق جهاز استقبال كروم كاست
  - تطبيق استقبال WebCast Chromecast
- صفحات gh
  - تطبيق استقبال WebCast Chromecast
    - يجب أن يشير رأس هذا الفرع دائمًا إلى/الاسم المستعار لرأس فرع تطبيق 00-chromecast-receiver-app
  - تستضيفه صفحات جيثب

ويسلط الضوء على كود المصدر

تحديد عناوين URL للفيديو في طلبات HTTP الصادرة
- BrowserWebViewClient
  - regex للكشف عن ملفات الفيديو
نفس المنهجية التي يتم تنفيذها بواسطة ملحق متصفح الويب
- ملحق Chromium "WebCast-Reloaded".
  - regex للكشف عن ملفات الفيديو