Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Server DNS-SD

Modul ini mencakup API untuk server DNS-SD.

Ringkasan

Enumerasi

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
Enumerasi ini menentukan jenis kueri DNS-SD.

Typedef

otDnssdCounters typedef
Struktur ini berisi penghitung server DNS-SD.
otDnssdHostInfo typedef
Struktur ini mewakili informasi host yang ditemukan untuk kueri DNS-SD.
otDnssdQuery typedef
void
Jenis buram ini mewakili kueri DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Fungsi ini dipanggil saat kueri DNS-SD berlangganan salah satu dari:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Fungsi ini dipanggil saat kueri DNS-SD menghentikan langganan salah satu dari:
otDnssdServiceInstanceInfo typedef
Struktur ini mewakili informasi instance layanan yang ditemukan untuk kueri DNS-SD.

Fungsi

otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
Fungsi ini menampilkan penghitung server DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Fungsi ini memperoleh kueri berikutnya di server DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Fungsi ini memperoleh jenis dan nama kueri DNS-SD untuk kueri tertentu.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Fungsi ini memberi tahu host yang ditemukan.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Fungsi ini memberi tahu instance layanan yang ditemukan.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Fungsi ini menyetel callback kueri server DNS-SD.

Struct

otDnssdCounters

Struktur ini berisi penghitung server DNS-SD.

otDnssdHostInfo

Struktur ini mewakili informasi host yang ditemukan untuk kueri DNS-SD.

otDnssdServiceInstanceInfo

Struktur ini mewakili informasi instance layanan yang ditemukan untuk kueri DNS-SD.

Enumerasi

otDnssdQueryType

 otDnssdQueryType

Enumerasi ini menentukan jenis kueri DNS-SD.

Properti
OT_DNSSD_QUERY_TYPE_BROWSE

Layanan penjelajahan jenis layanan.

OT_DNSSD_QUERY_TYPE_NONE

Jenis layanan tidak ditentukan.

OT_DNSSD_QUERY_TYPE_RESOLVE

Jenis layanan menyelesaikan instance layanan.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Jenis layanan menyelesaikan nama host.

Typedef

otDnssdCounters

struct otDnssdCounters otDnssdCounters

Struktur ini berisi penghitung server DNS-SD.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Struktur ini mewakili informasi host yang ditemukan untuk kueri DNS-SD.

otDnssdQuery

void otDnssdQuery

Jenis buram ini mewakili kueri DNS-SD.

otDnssdQuerySubscribeCallback

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

Fungsi ini dipanggil saat kueri DNS-SD berlangganan salah satu dari:

  1. nama layanan.
  2. nama instance layanan.
  3. nama host.

Implementasi kueri DNS-SD bertanggung jawab untuk mengidentifikasi apa itu aFullName. Jika aFullName adalah nama layanan atau nama instance layanan, implementasi kueri DNS-SD akan menemukan informasi instance layanan yang sesuai dan memberi tahu server DNS-SD menggunakan otDnssdQueryHandleDiscoveredServiceInstance. Jika aFullName adalah nama host, implementasi kueri DNS-SD akan menemukan informasi host dan memberi tahu server DNS-SD menggunakan otDnssdQueryHandleDiscoveredHost.

Detail
Parameter
[in] aContext
Pointer ke konteks khusus aplikasi.
[in] aFullName
Nama layanan lengkap yang diakhiri dengan null (misalnya "_ipps._tcp.default.service.arpa."), atau nama instance layanan lengkap (misalnya "OpenThread._ipps._tcp.default.service.arpa."), atau nama host lengkap (misalnya "ot-host.default.service.arpa)
Lihat juga:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

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

Fungsi ini dipanggil saat kueri DNS-SD menghentikan langganan salah satu dari:

  1. nama layanan.
  2. nama instance layanan.
  3. nama host.

Implementasi kueri DNS-SD bertanggung jawab untuk mengidentifikasi apa itu aFullName.

Detail
Parameter
[in] aContext
Pointer ke konteks khusus aplikasi.
[in] aFullName
Nama layanan lengkap yang diakhiri dengan null (misalnya "_ipps._tcp.default.service.arpa."), atau nama instance layanan lengkap (misalnya "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Struktur ini mewakili informasi instance layanan yang ditemukan untuk kueri DNS-SD.

Fungsi

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Fungsi ini menampilkan penghitung server DNS-SD.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
Menampilkan
Pointer ke penghitung server DNS-SD.

otDnssdGetNextQuery

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

Fungsi ini memperoleh kueri berikutnya di server DNS-SD.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aQuery
Pointer kueri. Meneruskan NULL untuk mendapatkan kueri pertama.
Menampilkan
Pointer ke kueri atau NULL jika tidak ada lagi kueri.

otDnssdGetQueryTypeAndName

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

Fungsi ini memperoleh jenis dan nama kueri DNS-SD untuk kueri tertentu.

Detail
Parameter
[in] aQuery
Pointer kueri yang diperoleh dari otDnssdGetNextQuery.
[out] aNameOutput
Buffering output nama, yang panjangnya harus OT_DNS_MAX_NAME_SIZE byte.
Menampilkan
Jenis kueri DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

Fungsi ini memberi tahu host yang ditemukan.

Resolver kueri eksternal (misalnya Proxy Discovery) harus memanggil fungsi ini untuk memberi tahu inti OpenThread tentang host yang berlangganan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aHostFullName
Nama host lengkap yang diakhiri dengan null.
[in] aHostInfo
Pointer ke informasi instance layanan yang ditemukan.

otDnssdQueryHandleDiscoveredServiceInstance

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

Fungsi ini memberi tahu instance layanan yang ditemukan.

Resolver kueri eksternal (misalnya Proxy Discovery) harus memanggil fungsi ini untuk memberi tahu inti OpenThread tentang layanan atau instance layanan yang berlangganan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aServiceFullName
Nama layanan lengkap yang diakhiri dengan null.
[in] aInstanceInfo
Pointer ke informasi instance layanan yang ditemukan.

otDnssdQuerySetCallbacks

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

Fungsi ini menyetel callback kueri server DNS-SD.

Server DNS-SD memanggil aSubscribe untuk berlangganan layanan atau instance layanan guna menyelesaikan kueri DNS-SD dan aUnsubscribe berhenti berlangganan saat kueri diselesaikan atau waktu tunggu habis.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aSubscribe
Pointer ke fungsi callback untuk berlangganan layanan atau instance layanan.
[in] aUnsubscribe
Pointer ke fungsi callback untuk menghentikan langganan layanan atau instance layanan.
[in] aContext
Pointer ke konteks khusus aplikasi.

Resource

Topik Referensi OpenThread API berasal dari kode sumber, yang tersedia di GitHub. Untuk mengetahui informasi selengkapnya, atau untuk berkontribusi ke dokumentasi kami, lihat Referensi.