mirror of
https://github.com/morgan9e/UxPlay
synced 2026-04-14 00:04:13 +09:00
README update for the BleuIO version of uxplay-beacon.py
This commit is contained in:
37
README.html
37
README.html
@@ -24,14 +24,16 @@ Bonjour/Rendezvous DNS-SD service discovery). <strong>This can be used
|
||||
on networks that do not allow the user to run a DNS_SD service.</strong>
|
||||
The user must run a Bluetooth LE “beacon”, (a USB 4.0 or later “dongle”
|
||||
can be used). The beacon is managed by a Python3 script
|
||||
<code>uxplay-beacon.py</code> (available in two versions, a BlueZ/DBus
|
||||
version for Linux/*BSD, and a winrt version for Windows). The beacon
|
||||
runs independently of UxPlay: while UxPlay is running, it regularly
|
||||
broadcasts a Bluetooth LE (“Low Energy”) 46 byte legacy-type
|
||||
advertisement informing nearby iOS/macOS devices of the local IPv4
|
||||
network address of the UxPlay server, and which TCP port to contact
|
||||
UxPlay on. Instructions are <a href="#bluetooth-le-beacon-setup">given
|
||||
below</a>.</p></li>
|
||||
<code>uxplay-beacon.py</code> (available in three versions, a BlueZ/DBus
|
||||
version for Linux/*BSD, a winrt version for Windows, and a version for
|
||||
the BlueIO usb-serial dongle (which has its own BlueTooth-LE stack
|
||||
independent of that of the host system) that runs on all systems
|
||||
including macOS). The beacon runs independently of UxPlay: while UxPlay
|
||||
is running, it regularly broadcasts a Bluetooth LE (“Low Energy”) 46
|
||||
byte legacy-type advertisement informing nearby iOS/macOS devices of the
|
||||
local IPv4 network address of the UxPlay server, and which TCP port to
|
||||
contact UxPlay on. Instructions are <a
|
||||
href="#bluetooth-le-beacon-setup">given below</a>.</p></li>
|
||||
<li><p>option <code>-vrtp <rest-of-pipeline></code> bypasses
|
||||
rendering by UxPlay, and instead transmits rtp packets of decrypted h264
|
||||
or h265 video to an external renderer (e.g. OBS Studio) at an address
|
||||
@@ -933,11 +935,12 @@ This should install the Bonjour SDK as
|
||||
<code>C:\Program Files\Bonjour SDK</code>.</li>
|
||||
</ol>
|
||||
<ul>
|
||||
<li><strong>NEW: while you still need to install the Bonjour SDK to
|
||||
build UxPlay, there is now an alternative method for Service Discovery
|
||||
using a Bluetooth Low Energy (BLE) beacon. A Windows-based python script
|
||||
for running the beacon is available for this.</strong> See <a
|
||||
href="#bluetooth-le-beacon-setup">instructions below</a>.</li>
|
||||
<li>**NEW: while you still need to install the Bonjour SDK to build
|
||||
UxPlay, there is now an alternative method for Service Discovery using a
|
||||
Bluetooth Low Energy (BLE) beacon. (Dfferent) Python3 scripts for
|
||||
running the beacon is on Linux/BSD*, Windows and macOS available for
|
||||
this.** See <a href="#bluetooth-le-beacon-setup">instructions
|
||||
below</a>.</li>
|
||||
</ul>
|
||||
<ol start="2" type="1">
|
||||
<li><p>(This is for 64-bit Windows; a build for 32-bit Windows should be
|
||||
@@ -1584,7 +1587,7 @@ default choice of BLE data file (<code>~/.uxplay.ble</code>) that is
|
||||
monitored by the beacon script. This also requires that uxplay is run
|
||||
with option “<code>uxplay -ble <BLE data file></code>”.</p></li>
|
||||
</ul>
|
||||
<p>The BlueZ/Dbus version has thee more options not offered by the
|
||||
<p>The BlueZ/Dbus version has three more options not offered by the
|
||||
Windows version (the Windows operating system chooses their values):</p>
|
||||
<ul>
|
||||
<li><p><code>--AdvMin x</code>, <code>--AdvMax y</code>. These controls
|
||||
@@ -1604,6 +1607,12 @@ instance of UxPlay must also have its own MAC address and ports).
|
||||
not been tested, and this option might not be useful or
|
||||
needed.</em></p></li>
|
||||
</ul>
|
||||
<p><strong>NEW</strong> While the native macOS BlueTooth-LE does not
|
||||
allow users to send “manufacturer-specific” advertisements like the
|
||||
uxplay service discovery announcement, this can be achieved using the
|
||||
BleuIO dongle, which is a usb-serial device with its own full
|
||||
BlueTooth-LE implementation (the bleuio version of uxplay-beacon.py is
|
||||
installed in macOS systems, but works on all operating systems).</p>
|
||||
<p>If you wish to test Bluetooth LE Service Discovery on Linux/*BSD, you
|
||||
can disable DNS_SD Service discovery by the avahi-daemon with</p>
|
||||
<pre><code>$ sudo systemctl mask avahi-daemon.socket
|
||||
|
||||
Reference in New Issue
Block a user