1ANDROID EMULATOR TRANSPORT
2==========================
3
4!!! warning
5    Bluetooth support in the Android emulator has recently changed. The older mode, using
6    the `android-emulator` transport name with Bumble, while still implemented, is now
7    obsolete, and may not be supported by recent versions of the emulator.
8    Use the `android-netsim` transport name instead.
9
10
11The Android "netsim" transport either connects, as a host, to a **Netsim** virtual controller
12("host" mode), or acts as a virtual controller itself ("controller" mode) accepting host
13connections.
14
15## Moniker
16The moniker syntax for an Android Emulator "netsim" transport is: `android-netsim:[<host>:<port>][<options>]`,
17where `<options>` is a comma-separated list of `<name>=<value>` pairs.
18The `mode` parameter name can specify running as a host or a controller, and `<hostname>:<port>` can specify a host name (or IP address) and TCP port number on which to reach the gRPC server for the emulator (in "host" mode), or to accept gRPC connections (in "controller" mode).
19Both the `mode=<host|controller>` and `<hostname>:<port>` parameters are optional (so the moniker `android-netsim` by itself is a valid moniker, which will create a transport in `host` mode, connected to `localhost` on the default gRPC port for the Netsim background process).
20
21!!! example Example
22    `android-netsim`
23    connect as a host to Netsim on the gRPC port discovered automatically.
24
25!!! example Example
26    `android-netsim:_:8555,mode=controller`
27    Run as a controller, accepting gRPC connection on port 8555.
28
29!!! example Example
30    `android-netsim:localhost:8555`
31    connect as a host to Netsim on localhost:8555
32
33!!! example Example
34    `android-netsim:localhost:8555`
35    connect as a host to Netsim on localhost:8555
36
37!!! example Example
38    `android-netsim:name=bumble1234`
39    connect as a host to Netsim on the discovered gRPC port, using `bumble1234` as the
40    controller instance name.
41
42