chrome.mdns

الوصف

استخدِم واجهة برمجة التطبيقات chrome.mdns لاكتشاف الخدمات عبر mDNS. يتألف هذا من مجموعة فرعية من ميزات مواصفات NSD: http://www.w3.org/TR/discovery-api/

الأذونات

mdns

مدى التوفّر

الإصدار 43 من Chrome أو الإصدارات الأحدث

الأنواع

MDnsService

الخصائص

  • ipAddress

    سلسلة

    عنوان IP لخدمة معلَن عنها في mDNS

  • serviceData

    string[]

    البيانات الوصفية لخدمة معلَن عنها عبر mDNS

  • serviceHostPort

    سلسلة

    يشير هذا الحقل إلى زوج المضيف:المنفذ لخدمة معلَن عنها عبر mDNS.

  • serviceName

    سلسلة

    اسم الخدمة المُعلَن عنها في mDNS، ..

الخصائص

MAX_SERVICE_INSTANCES_PER_EVENT

الإصدار 44 من Chrome أو الإصدارات الأحدث

الحد الأقصى لعدد مثيلات الخدمة التي سيتم تضمينها في أحداث onServiceList. إذا توفّرت مثيلات أخرى، قد يتم اقتطاعها من الحدث onServiceList.

القيمة

2048

الطُرق

forceDiscovery()

Promise الإصدار 45 من Chrome والإصدارات الأحدث 
chrome.mdns.forceDiscovery(
  callback?: function,
): Promise<void>

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

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 96 من Chrome أو الإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

الفعاليات

onServiceList

chrome.mdns.onServiceList.addListener(
  callback: function,
)

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

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (services: MDnsService[]) => void