BluetoothStatusConnection Class |
Namespace: Zebra.Sdk.Comm
The BluetoothStatusConnection type exposes the following members.
Name | Description | |
---|---|---|
BluetoothStatusConnection(String) |
Constructs a new Bluetooth® connection with the given macAddress.
| |
BluetoothStatusConnection(String, Int32, Int32) |
Constructs a new Bluetooth® connection with the givenmacAddress and timeout values.
|
Name | Description | |
---|---|---|
Connected |
Returns true if the connection is open.
(Inherited from ConnectionA.) | |
FriendlyName |
Gets the friendly name of the Bluetooth® connection. The friendly name is obtained from the device when
this connection is opened.If the friendly name changes on the device, it will not be refreshed until the
connection is closed and reopened.
| |
MACAddress |
Gets the MAC address which was passed into the constructor. The MAC address is a hexadecimal string with
separators between the octets. (e.g. 00:11:BB:DD:55:FF).
| |
Manufacturer |
See the classes which implement this property for the format of the printer manufacturer string.
(Inherited from ConnectionA.) | |
MaxDataToWrite |
Gets or sets the maximum number of bytes to write at one time
(Inherited from ConnectionA.) | |
MaxTimeoutForRead |
Gets or sets the maximum time, in milliseconds, to wait for any data to be received.
(Inherited from ConnectionA.) | |
MultipartTimeToWaitAfterSend | (Inherited from ConnectionA.) | |
SimpleConnectionName |
Gets the MAC address and the friendly name as the description.
(Overrides ConnectionASimpleConnectionName.) | |
TimeToWaitForMoreData |
Gets or sets the maximum time, in milliseconds, to wait in-between reads after the initial read.
(Inherited from ConnectionA.) |
Name | Description | |
---|---|---|
AddWriteLogStream |
Sets the stream to log the write data to.
(Inherited from ConnectionA.) | |
BytesAvailable |
Returns an estimate of the number of bytes that can be read from this connection without blocking.
(Overrides ConnectionABytesAvailable.) | |
Close |
Closes the Bluetooth® connection.
(Overrides ConnectionAClose.) | |
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) | |
GetConnectionReestablisher(Int64) | (Overrides ConnectionAGetConnectionReestablisher(Int64).) | |
GetConnectionReestablisher(Int64) |
Returns a ConnectionReestablisher which allows for easy recreation of a connection which may have been closed.
(Inherited from ConnectionA.) | |
GetHashCode | Serves as the default hash function. (Inherited from Object.) | |
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
Open |
Opens a Bluetooth® connection as specified in the constructor.
(Overrides ConnectionAOpen.) | |
Read |
Reads all the available data from the connection. This call is non-blocking.
(Inherited from ConnectionA.) | |
Read(Int32) |
Reads maxBytesToRead of the available data from the connection.
(Overrides ConnectionARead(Int32).) | |
Read(Int32) |
Reads maxBytesToRead of the available data from the connection.
(Inherited from ConnectionA.) | |
Read(BinaryWriter) |
Reads all the available data from the connection.
(Inherited from ConnectionA.) | |
Read(Int32, Boolean) |
Reads maxBytesToRead of the available data from the connection.
(Inherited from ConnectionA.) | |
ReadChar |
Reads the next byte of data from the connection.
(Overrides ConnectionAReadChar.) | |
ReadChar |
Reads the next byte of data from the connection.
(Inherited from ConnectionA.) | |
SendAndWaitForResponse(Byte, Int32, Int32, String) |
Sends dataToSend and returns the response data.
(Inherited from ConnectionA.) | |
SendAndWaitForResponse(BinaryWriter, BinaryReader, Int32, Int32, String) |
Sends data from sourceStream and writes the response data to destinationStream.
(Inherited from ConnectionA.) | |
SendAndWaitForValidResponse(Byte, Int32, Int32, ResponseValidator) |
Sends dataToSend and returns the response data.
(Inherited from ConnectionA.) | |
SendAndWaitForValidResponse(BinaryWriter, BinaryReader, Int32, Int32, ResponseValidator) |
Sends data from sourceStream and writes the response data to destinationStream.
(Inherited from ConnectionA.) | |
SetReadTimeout |
Sets the underlying read timeout value.
(Inherited from ConnectionA.) | |
ToString |
The friendly name is obtained from the device when this connection is opened. If the friendly name changes on the
device, it will not be refreshed until the connection is closed and reopened.
(Overrides ConnectionAToString.) | |
WaitForData |
Causes the currently executing thread to sleep until BytesAvailable > 0, or for a maximum of
maxTimeout milliseconds.
(Inherited from ConnectionA.) | |
Write(Byte) |
Writes data.Length bytes from the specified byte array to this output stream.
(Inherited from ConnectionA.) | |
Write(BinaryReader) |
Writes all available bytes from the data source to this output stream.
(Inherited from ConnectionA.) | |
Write(Byte, Int32, Int32) |
Writes length bytes from data starting at offset.
(Inherited from ConnectionA.) |
using System; using Zebra.Sdk.Comm; using Zebra.Sdk.Printer; public class BluetoothStatusConnectionExample { public static void Main(string[] args) { BluetoothStatusConnectionExample example = new BluetoothStatusConnectionExample(); string theBtMacAddress = "00:11:BB:DD:55:FF"; example.SendJSONOverStatusChannel(theBtMacAddress); } private void SendJSONOverStatusChannel(string theBtMacAddress) { Connection printConn = null; Connection statusConn = null; try { // The printing channel must be opened before the status channel. // Instantiate a printing connection for given Bluetooth® MAC Address. printConn = new BluetoothConnection(theBtMacAddress); // Open the connection - physical connection is established here. printConn.Open(); // Instantiate a status connection for given Bluetooth® MAC Address. statusConn = new BluetoothStatusConnection(theBtMacAddress); // Open the connection - physical connection is established here. statusConn.Open(); // This sends down JSON to the status channel to retrieve the 'appl.name' setting string firmwareVersion = SGD.GET("appl.name", statusConn); Console.WriteLine($"The firmware version is: {firmwareVersion}"); } catch (Exception e) { // Handle communications error here. Console.WriteLine(e.ToString()); } finally { // Close the connections to release resources. if (statusConn != null) { statusConn.Close(); } if (printConn != null) { printConn.Close(); } } } }
using Android.App; using Android.OS; using Android.Views; using Android.Widget; using System; using System.Threading.Tasks; using Zebra.Sdk.Comm; using Zebra.Sdk.Printer; public class BluetoothStatusConnectionExample : Activity { protected override void OnCreate(Bundle savedInstanceState) { base.OnCreate(savedInstanceState); LinearLayout layout = (LinearLayout)View.Inflate(this, Android.Resource.Layout.ActivityListItem, null); layout.Orientation = Orientation.Vertical; Button buttonPrint = new Button(this) { Text = "Run Bluetooth Status Connection Example", LayoutParameters = new ViewGroup.LayoutParams(new LinearLayout.LayoutParams(ViewGroup.LayoutParams.WrapContent, ViewGroup.LayoutParams.WrapContent)) }; layout.AddView(buttonPrint); SetContentView(layout); buttonPrint.Click += async (sender, e) => { string theBtMacAddress = "00:11:BB:DD:55:FF"; await Task.Run(() => { SendJSONOverStatusChannel(theBtMacAddress); }); }; } private void SendJSONOverStatusChannel(string theBtMacAddress) { Connection printConn = null; Connection statusConn = null; try { // The printing channel must be opened before the status channel. // Instantiate a printing connection for given Bluetooth® MAC Address. printConn = new BluetoothConnection(theBtMacAddress); // Instantiate a status only connection for given Bluetooth® MAC Address. statusConn = new BluetoothStatusConnection(theBtMacAddress); // Open the connection - physical connection is established here. printConn.Open(); // Open the connection - physical connection is established here. statusConn.Open(); // This sends down JSON to the status channel to retrieve the 'appl.name' setting. string firmwareVersion = SGD.GET("appl.name", statusConn); // This prints out the firmware version in a toast message in the app. RunOnUiThread(() => { Toast.MakeText(this.ApplicationContext, $"The firmware version is: {firmwareVersion}", ToastLength.Long).Show(); }); } catch (Exception e) { // Handle communications error here. Console.WriteLine(e.ToString()); } finally { // Close the connections to release resources. if (statusConn != null) { statusConn.Close(); } if (printConn != null) { printConn.Close(); } } } }