استخدام جميع ميزات CamRelay في Frigate NVR

يُدخل CamRelay هاتف Android إلى Frigate عبر عنوان RTSP واحد فقط. ويتولى go2rtc، المدمج في Frigate، استقبال هذا البث وتوزيعه على المسجّل والعرض المباشر وقناة المحادثة ثنائية الاتجاه.

CamRelay تطبيق من Banana Studio يحوّل الهاتف إلى كاميرا IP على شبكتك المحلية. يبث فيديو H.264 أو H.265 مع صوت Opus أو G.711 أو AAC. ويوفّر واجهة ويب، ويدعم ONVIF، ويستقبل الصوت من المشاهدين عبر قناة RTSP العكسية (backchannel).

مسار البيانات: هاتف يعمل بتطبيق CamRelay ← go2rtc (داخل Frigate) ← التسجيل، والعرض المباشر مع الصوت، والمحادثة ثنائية الاتجاه.

تعتمد الإعدادات أدناه على Frigate 0.16. قد تتغير بعض المفاتيح في الإصدارات اللاحقة، لذا راجع وثائق Frigate الرسمية.

ميزات CamRelay في Frigate

تصل الميزات الأربع الأولى إلى Frigate عبر go2rtc. أما البقية فتُضبط في التطبيق، وتحافظ على استمرار البث على مدار الساعة طوال أيام الأسبوع.

قبل أن تبدأ

ستحتاج إلى:

• خادم Frigate مثبّت ويعمل (راجع دليل تثبيت Frigate)، على الشبكة المحلية نفسها التي يتصل بها الهاتف.
• هاتف Android مثبّت عليه CamRelay، موصول بالشاحن بشكل دائم، وله عنوان IP ثابت محدد في جهاز التوجيه (الراوتر).
• على Android 17: اسمح لتطبيق CamRelay بـ الوصول إلى الشبكة المحلية (يعرضه Android ضمن الأجهزة المجاورة). بدون هذا الإذن لا يستطيع Frigate الاتصال بالهاتف. راجع مقال CamRelay 1.0.5.

يجب أن تفتح حاوية Frigate المنافذ التالية لاستخدام جميع ميزات CamRelay:

الخطوة 1: إعداد CamRelay

يتبع CamRelay لغة الهاتف؛ أسماء الإعدادات أدناه هي الأسماء العربية. ملاحظة: فتح الإعدادات يوقف البث. وبعد تشغيل CamRelay يمكنك تغيير الإعدادات من واجهة الويب دون إيقافه.

1.1 منفذ RTSP

يعرض قسم منافذ الخادم كلًّا من منفذ بث RTSP (الافتراضي 1935) ومنفذ واجهة الويب (الافتراضي 8888). القيم الافتراضية مناسبة.

1.2 الفيديو

1. من تحديد الكاميرا، اختر الكاميرا التي ستستخدمها (الكاميرا الخلفية تعطي عادةً صورة أفضل).
2. افتح الإعدادات الخاصة بتلك الكاميرا واختر الدقة ومعدل الإطارات (FPS) ومعدل بت الفيديو. تعتمد الدقات ومعدلات الإطارات المتاحة على كاميرا الهاتف.
3. من إعدادات الفيديو العامة ← ترميز الفيديو، اختر H.264 حتى تتمكن المتصفحات من تشغيل العرض المباشر.
4. اترك فاصل الإطارات الرئيسية (GOP) على 1s (الافتراضي) حتى يُفتح العرض المباشر بسرعة.

لأغراض المراقبة، تكفي دقة 1080p بمعدل 15 إطارًا في الثانية، وهي خفيفة على خادم Frigate. يوفّر H.265 عرض النطاق الترددي، لكن على Frigate تحويل ترميزه ليعمل في المتصفح (راجع الخطوة 2.2).

1.3 الصوت

من إعدادات الصوت، فعّل تمكين الصوت. يُختار ترميز الصوت للبث من المحادثة ثنائية الاتجاه ← ترميز صوت المحادثة ثنائية الاتجاه. ينطبق هذا الإعداد الواحد على الصوت الصادر وعلى المحادثة ثنائية الاتجاه معًا:

• G.711 ULAW: الخيار الموصى به مع Frigate، إذ يعمل مباشرة في MSE وWebRTC كليهما (راجع الخطوة 2.2).
• OPUS: الافتراضي بدءًا من Android 10، وصوته أوضح، لكنه لا يعمل إلا عبر WebRTC.
• G.711 ALAW: فقط إذا كان جهاز الاستماع يتطلب A-law.
• AAC: للتشغيل فقط؛ وتحتاج المحادثة ثنائية الاتجاه إلى تحويل الترميز.

اترك وضع صوت المحادثة ثنائية الاتجاه على الاتصال الصوتي: فهو يتضمن إلغاء الصدى، فلا يحدث صفير أثناء المحادثة ثنائية الاتجاه.

1.4 التراكبات والتسجيل والتشغيل على مدار الساعة

• تراكب الفيديو: اعرض التاريخ والوقت، واسم الكاميرا (اسم الكاميرا؛ اتركه فارغًا لاستخدام اسم الجهاز)، وعنوان IP، والبطارية ودرجة الحرارة، وإحداثيات GPS، أو عدّاد السرعة. تُرسم التراكبات داخل الفيديو نفسه، لذا تظهر أيضًا في تسجيلات Frigate. جميعها معطّلة افتراضيًا.
• إعدادات التسجيل: فعّل تمكين التسجيل للاحتفاظ بنسخة احتياطية على الهاتف. تُحفظ ملفات MP4 في Movies/CamRelay، وتُقسَّم حسب مدة مقطع التسجيل (بالدقائق). وعند بلوغ الحد الأقصى للتخزين (ميغابايت) تُحذف أقدم الملفات.
• الأمان والأتمتة: فعّل تشغيل تلقائي عند بدء تشغيل الجهاز حتى يستأنف CamRelay البث بعد إعادة تشغيل الهاتف. على Android 10 والإصدارات الأحدث، يحتاج التطبيق أيضًا إلى إذن الظهور فوق التطبيقات الأخرى. يوقف أمان درجة الحرارة وأمان البطارية البث مؤقتًا عندما ترتفع حرارة الهاتف كثيرًا أو تنخفض البطارية، ثم يستأنفانه عند عودة الأمور إلى طبيعتها.
• تحسين البطارية: تأكد من إيقاف تحسين البطارية لتطبيق CamRelay، حتى لا يوقفه Android في الخلفية.

1.5 بدء البث والحصول على العنوان

ارجع إلى الشاشة الرئيسية واضغط على زر التشغيل. يعرض الشريط العلوي الدقة ومعدل الإطارات ومعدل البت والترميزات المستخدمة. وتعرض الزاوية السفلية ثلاثة عناوين، لكلٍّ منها زر نسخ:

• rtsp://<phone-ip>:1935/: عنوان RTSP الخاص بـ Frigate.
• http://<phone-ip>:8888: واجهة الويب الخاصة بـ CamRelay.
• http://<phone-ip>:8889/onvif/device_service: خدمة ONVIF.

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

تستخدم الأمثلة أدناه العنوان rtsp://192.168.1.50:1935/؛ استبدله بالعنوان الذي يعرضه CamRelay. لا يطلب الإصدار الحالي من CamRelay تسجيل الدخول على RTSP بعد، لذا استخدمه فقط على شبكة تثق بها.

قريبًا: سيتيح تحديث CamRelay القادم تعيين اسم مستخدم وكلمة مرور لحماية بث RTSP. وعندها يكفي إضافتهما إلى العنوان في go2rtc، مثل rtsp://user:[email protected]:1935/.

يمكنك التحقق من البث من خادم Frigate باستخدام ffprobe:

ffprobe -rtsp_transport tcp rtsp://192.168.1.50:1935/

يجب أن تُظهر النتيجة بث فيديو h264 وبث صوت (pcm_mulaw مع G.711 ULAW، وopus مع OPUS).

الخطوة 2: إعداد go2rtc في Frigate

go2rtc داخل Frigate هو الوحيد الذي يتصل بالهاتف. فهو يسحب بث RTSP من CamRelay مرة واحدة ويوزّعه على التسجيل والاكتشاف والعرض المباشر (MSE وWebRTC) والمحادثة ثنائية الاتجاه. أما Frigate نفسه فيقرأ من rtsp://127.0.0.1:8554/camrelay، فلا يضطر الهاتف إلى خدمة عدة اتصالات في وقت واحد. وهذا يحافظ على برودة الهاتف ويوفّر البطارية.

2.1 إضافة البث

أضف كتلة go2rtc إلى ~/frigate/config/config.yml:

go2rtc:
  streams:
    camrelay:                              # الاسم نفسه لكاميرا Frigate
      - rtsp://192.168.1.50:1935/          # العنوان الذي يعرضه CamRelay
  webrtc:
    candidates:
      - 192.168.1.100:8555   # عنوان IP لخادم Frigate
      - stun:8555

• يكفي سطر RTSP واحد. مع صوت G.711 أو Opus، يمرّر go2rtc الفيديو والصوت مباشرة إلى المتصفح دون تحويل ترميز عبر ffmpeg:. ويحمل سطر RTSP نفسه أيضًا قناة المحادثة ثنائية الاتجاه.
• الإعداد webrtc.candidates مطلوب عند التشغيل عبر Docker العادي؛ وبدونه لا يعمل WebRTC ولا الميكروفون على الشبكة المحلية. وقد فُتح المنفذ 8555 TCP/UDP في قسم "قبل أن تبدأ".
• عندما يحمل البث الاسم نفسه الذي تحمله الكاميرا، يستخدمه Frigate تلقائيًا للعرض المباشر. وإلا فاضبط live.streams للكاميرا.

2.2 الترميزات والصوت

اضبط CamRelay على فيديو H.264. ويُعد G.711 أبسط خيار للصوت. وفقًا لوثائق Frigate، يشغّل MSE (العرض المباشر الافتراضي) صوت AAC أو PCMA/PCMU، ويشغّل WebRTC (المستخدم في المحادثة ثنائية الاتجاه) صوت Opus أو PCMA/PCMU. ولا يعمل مباشرة في كليهما سوى G.711.

صوت Opus أوضح من G.711 (جودة الهاتف بتردد 8 kHz) إذا كنت تشاهد غالبًا عبر WebRTC. وإذا اضطررت إلى استخدام H.265، فأضف سطرًا لتحويل ترميز الفيديو واحتفظ بسطر RTSP:

go2rtc:
  streams:
    camrelay:
      - rtsp://192.168.1.50:1935/
      - "ffmpeg:camrelay#video=h264#hardware"   # نسخة H.264 للمتصفحات

2.3 المحادثة ثنائية الاتجاه

أثناء البث، يكون CamRelay جاهزًا دائمًا لاستقبال الصوت عبر قناة RTSP العكسية؛ ولا يوجد مفتاح يلزم تفعيله. يفتح go2rtc هذه القناة من سطر RTSP في الخطوة 2.1، دون أي إعداد إضافي.

للتحدث، افتح Frigate عبر HTTPS على المنفذ 8971، وانتقل إلى العرض المباشر للكاميرا واضغط على الميكروفون؛ سينتقل Frigate إلى WebRTC تلقائيًا. يُسمع صوتك من مكبر صوت الهاتف بمستوى الصوت المضبوط في مستوى صوت التشغيل داخل CamRelay.

إذا كان تطبيق آخر يحتاج أيضًا إلى التحدث مع الهاتف مباشرة، فأضف #backchannel=0 إلى نهاية عنوان RTSP حتى لا يحتجز go2rtc القناة.

2.4 إضافة الكاميرا إلى Frigate

أضف كتلة cameras أسفل كتلة go2rtc. تقرأ الكاميرا البث من go2rtc بدلًا من الاتصال بالهاتف مباشرة:

cameras:
  camrelay:
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/camrelay   # بث go2rtc من الخطوة 2.1
          input_args: preset-rtsp-restream
          roles:
            - record
            - detect   # مطلوب في Frigate، ولا يحتاج إلى أي إعداد آخر
    record:
      enabled: true

يرسل CamRelay بثًا واحدًا (لا يوجد بث فرعي)، لذا تستخدمه الكاميرا للتسجيل والاكتشاف معًا.

أعد التشغيل وتحقق:

docker compose restart frigate
docker logs -f frigate

للتحقق من go2rtc وحده، أضف المنفذ 1984:1984 مؤقتًا إلى docker-compose وافتح http://<server-ip>:1984. يجب أن يحتوي البث camrelay على مصدر RTSP بفيديو H264 وصوت PCMU/PCMA أو OPUS. وعندما يظهر CamRelay في الصفحة الرئيسية لـ Frigate، تكون قد انتهيت.

الخطوة 3: ملف config.yml كامل

يحتوي الملف أدناه على ما يحتاجه CamRelay فقط: بث go2rtc، وWebRTC، وتسجيل الدخول (لتفعيل HTTPS الذي تحتاجه المحادثة ثنائية الاتجاه)، والتسجيل مع الصوت.

go2rtc:
  streams:
    camrelay:
      - rtsp://192.168.1.50:1935/   # العنوان الذي يعرضه CamRelay، H.264 + G.711 ULAW
  webrtc:
    candidates:
      - 192.168.1.100:8555   # عنوان IP لخادم Frigate
      - stun:8555

auth:
  enabled: true

cameras:
  camrelay:
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/camrelay
          input_args: preset-rtsp-restream
          roles: [record, detect]   # detect: مطلوب في Frigate
    record:
      enabled: true
    live:
      streams:
        CamRelay: camrelay

version: 0.16-0

استكشاف الأخطاء وإصلاحها

ترجع معظم المشكلات عند إضافة CamRelay إلى Frigate إلى عنوان البث أو الترميزات أو الشبكة.

عند طلب المساعدة في GitHub Discussions الخاص بـ Frigate، أرفق ملف الإعدادات وسجل بدء التشغيل ونتيجة ffprobe لبث CamRelay. ولأسئلة CamRelay، اضغط على ملاحظات في شاشة حول داخل التطبيق.

احصل على CamRelay من Google Play

اكتشف المزيد من الأخبار والأدلة وتطبيقات Banana Studio على xnano.net.

المصادر: وثائق Live View في Frigate بالنسبة إلى go2rtc؛ ودليل مستخدم CamRelay وصفحة التطبيق على Google Play بالنسبة إلى CamRelay.