6.1-roNetworkAdvertisement

Owned by Anonymous
Sept 28, 2021
1 min read


This object is used to advertise services running on a BrightSign player to other devices on the network. The current implementation supports advertising via mDNS (which is part of Zeroconf via Bonjour™).

Object creation: The roNetworkAdvertisement object is created with an associative array of network parameters and arbitrary text information.

CreateObject("roNetworkAdvertisement", advertisement As roAssociativeArray) As Object

The roAssociativeArray can contain the following keys:

  • name: The service name. This should be a readable string such as "Remote BrightSign Widget Service."
  • type: The service type. This should be a service from the definitive list, formatted in the following manner: "_service._protocol" (for example, "_http._tcp").
  • port: The port number on which the service runs.
  • _name: Any arbitrary text key preceded by an underscore to avoid conflicts within the roAssociativeArray.

Note

The underscore is removed before the record is registered with mDNS.

Once the object is created, advertising starts immediately and continues until the object is destroyed (i.e. when it becomes unreferenced).

There are no interfaces on the roNetworkAdvertisement object.

Example
di = CreateObject("roDeviceInfo")
 props = { name: "My Hoopy Service", type: "_http._tcp", port: 8080, _serial:
di.GetDeviceUniqueId() }
 advert = CreateObject("roNetworkAdvertisement", props)
 ...
 ' Stop advertising
 advert = invalid