DNS-SD Sunucu

Bu modül DNS-SD sunucu için API'ler içerir.

Özet

Sıralamalar

otDnssdQueryType{
  OT_DNSSD_QUERY_TYPE_NONE = 0,
  OT_DNSSD_QUERY_TYPE_BROWSE = 1,
  OT_DNSSD_QUERY_TYPE_RESOLVE = 2,
  OT_DNSSD_QUERY_TYPE_RESOLVE_HOST = 3
}
enum
Bu sıralamada DNS-SD sorgu türü belirtilir.

Türler

otDnssdCounters Tür
Bu yapı DNS-SD sunucunun sayaçlarını içerir.
otDnssdHostInfo Tür
Bu yapı, DNS-SD sorgusu için keşfedilen bir ana makinenin bilgilerini temsil eder.
otDnssdQuery Tür
void
Bu opak tür, DNS-SD sorgusunu temsil eder.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) Tür
void(*
Bu işlev, bir DNS-SD sorgusu aşağıdakilerden birine abone olduğunda çağrılır:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) Tür
void(*
Bu işlev, DNS-SD sorgusu aşağıdakilerden birinin aboneliğinden çıktığında çağrılır:
otDnssdServiceInstanceInfo Tür
Bu yapı, DNS-SD sorgusu için keşfedilen bir hizmet örneğinin bilgilerini temsil eder.

İşlevler

otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
Bu işlev, DNS-SD sunucunun sayaçlarını döndürür.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Bu işlev, DNS-SD sunucudaki bir sonraki sorguyu alır.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Bu işlev, belirli bir sorgu için DNS-SD sorgu türünü ve adını alır.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Bu işlev, keşfedilen bir ana makineyi bilgilendirir.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Bu işlev, keşfedilen bir hizmet örneğini bildirir.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Bu işlev, DNS-SD sunucu sorgusu geri çağırmalarını ayarlar.

Struct

otDnssdSayaçlar

Bu yapı DNS-SD sunucunun sayaçlarını içerir.

otDnssdHostBilgileri

Bu yapı, DNS-SD sorgusu için keşfedilen bir ana makinenin bilgilerini temsil eder.

otDnssdServiceInstanceBilgileri

Bu yapı, DNS-SD sorgusu için keşfedilen bir hizmet örneğinin bilgilerini temsil eder.

Sıralamalar

otDnssdQueryTürü

 otDnssdQueryType

Bu sıralamada DNS-SD sorgu türü belirtilir.

Özellikler
OT_DNSSD_QUERY_TYPE_BROWSE

Hizmet türü göz atma hizmeti.

OT_DNSSD_QUERY_TYPE_NONE

Hizmet türü belirtilmedi.

OT_DNSSD_QUERY_TYPE_RESOLVE

Hizmet türü hizmet örneğini çöz.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Hizmet türü, ana makine adını çözümlediğinden.

Türler

otDnssdSayaçlar

struct otDnssdCounters otDnssdCounters

Bu yapı DNS-SD sunucunun sayaçlarını içerir.

otDnssdHostBilgileri

struct otDnssdHostInfo otDnssdHostInfo

Bu yapı, DNS-SD sorgusu için keşfedilen bir ana makinenin bilgilerini temsil eder.

otDnssdSorgu

void otDnssdQuery

Bu opak tür, DNS-SD sorgusunu temsil eder.

otDnssdQuerySubscribeCallBackback

void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)

Bu işlev, bir DNS-SD sorgusu aşağıdakilerden birine abone olduğunda çağrılır:

  1. bir hizmet adı veriyor.
  2. bir hizmet örneği adı gerekir.
  3. ana makine adı.

DNS-SD sorgu uygulaması, aFullName öğesinin ne olduğunu tanımlamaktan sorumludur. aFullName bir hizmet adı veya hizmet örneği adıysa, DNS-SD sorgu uygulaması ilgili hizmet örneği bilgilerini bulmalı ve DNS-SD sunucusunu otDnssdQueryHandleDiscoveredServiceInstance kullanarak bilgilendirmelidir. aFullName bir ana makine adıysa DNS-SD sorgu uygulaması ana makine bilgilerini bulmalı ve DNS-SD sunucusunu otDnssdQueryHandleDiscoveredHost kullanarak bilgilendirmelidir.

Ayrıntılar
Parametreler
[in] aContext
Uygulamaya özel bağlama işaretçi.
[in] aFullName
Boş sonlandırmalı tam hizmet adı (ör. "_ipps._tcp.default.service.arpa.&quot); veya tam hizmet örneği adı (ör."OpenThread._ipps._tcp.default.service.arpa.") veya tam ana makine adı (ör. "ot.ar.host.service.default.a.a.a.a)
Şunları da inceleyin:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)

Bu işlev, DNS-SD sorgusu aşağıdakilerden birinin aboneliğinden çıktığında çağrılır:

  1. bir hizmet adı veriyor.
  2. bir hizmet örneği adı gerekir.
  3. ana makine adı.

DNS-SD sorgu uygulaması, aFullName öğesinin ne olduğunu tanımlamaktan sorumludur.

Ayrıntılar
Parametreler
[in] aContext
Uygulamaya özel bağlama işaretçi.
[in] aFullName
Boş sonlandırılmış tam hizmet adı (ör. "_ipps._tcp.default.service.arpa.&quot); veya tam hizmet örneği adı (ör. "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceBilgileri

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Bu yapı, DNS-SD sorgusu için keşfedilen bir hizmet örneğinin bilgilerini temsil eder.

İşlevler

otDnssdGetSayaçlar

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Bu işlev, DNS-SD sunucunun sayaçlarını döndürür.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği yapısı.
İadeler
DNS-SD sunucusunun sayaçlarına bir işaretçidir.

otDnssdGetNextSorgusu

const otDnssdQuery * otDnssdGetNextQuery(
  otInstance *aInstance,
  const otDnssdQuery *aQuery
)

Bu işlev, DNS-SD sunucudaki bir sonraki sorguyu alır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği yapısı.
[in] aQuery
Sorgu işaretçisi. İlk sorguyu almak için BOŞ yap.
İadeler
Sorguya işaretçi veya başka sorgu yoksa BOŞ

otDnssdGetQueryTypeAndName

otDnssdQueryType otDnssdGetQueryTypeAndName(
  const otDnssdQuery *aQuery,
  char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE]
)

Bu işlev, belirli bir sorgu için DNS-SD sorgu türünü ve adını alır.

Ayrıntılar
Parametreler
[in] aQuery
Sorgu işaretçisi otDnssdGetNextQuery kaynağından alındı.
[out] aNameOutput
Ad bayt arabelleği (OT_DNS_MAX_NAME_SIZE bayt uzunluğunda olmalıdır).
İadeler
DNS-SD sorgu türü.

otDnssdQueryHandleDiscoveredAna Makine

void otDnssdQueryHandleDiscoveredHost(
  otInstance *aInstance,
  const char *aHostFullName,
  otDnssdHostInfo *aHostInfo
)

Bu işlev, keşfedilen bir ana makineyi bilgilendirir.

Harici sorgu çözücü (ör. Discovery Proxy), abone olunan ana makinelerin OpenThread çekirdeğine bildirim göndermek için bu işlevi çağırmalıdır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği yapısı.
[in] aHostFullName
Boş sonlandırılmış tam ana makine adı.
[in] aHostInfo
Keşfedilen hizmet örneği bilgilerinin işaretçisi.

otDnssdQueryHandleDiscoveredServiceInstance

void otDnssdQueryHandleDiscoveredServiceInstance(
  otInstance *aInstance,
  const char *aServiceFullName,
  otDnssdServiceInstanceInfo *aInstanceInfo
)

Bu işlev, keşfedilen bir hizmet örneğini bildirir.

Harici sorgu çözücü (ör. Discovery Proxy), abone olunan hizmetlerin veya hizmet örneklerinin OpenThread çekirdeğini bilgilendirmek için bu işlevi çağırmalıdır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği yapısı.
[in] aServiceFullName
Boş sonlandırılmış tam hizmet adı.
[in] aInstanceInfo
Keşfedilen hizmet örneği bilgilerinin işaretçisi.

otDnssdQuerySet Geri Çağırmaları

void otDnssdQuerySetCallbacks(
  otInstance *aInstance,
  otDnssdQuerySubscribeCallback aSubscribe,
  otDnssdQueryUnsubscribeCallback aUnsubscribe,
  void *aContext
)

Bu işlev, DNS-SD sunucu sorgusu geri çağırmalarını ayarlar.

DNS-SD sunucu, bir DNS-SD sorgusunu çözümlemek üzere hizmet veya hizmet örneğine abone olmak için aSubscribe, sorgu çözümlendiğinde veya zaman aşımı olduğunda aUnsubscribe aboneliğinden çıkmak için çağrı yapar.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği yapısı.
[in] aSubscribe
Bir hizmet veya hizmet örneğine abone olmak için geri çağırma işlevinin işaretçisi.
[in] aUnsubscribe
Bir hizmet veya hizmet örneğinin aboneliğinden çıkmak için geri çağırma işlevinin işaretçisi.
[in] aContext
Uygulamaya özel bağlama işaretçi.

Kaynaklar

OpenThread API Referans konularının kaynağı, GitHub'daki kaynak kodudur. Daha fazla bilgi edinmek veya dokümanlarımıza katkıda bulunmak için Kaynaklar'a bakın.