Getting Started - Windows¶
Try a sample app. For Xamarin: Capture Xamarin SDK Sample, for Maui: Capture Maui SDK Sample.
Requirements¶
The Host PC needs to have Socket Mobile Companion app installed. It can be downloaded here.
An application using the Socket CaptureSDK needs to be registered in order to retrieve an AppKey that is required by the Capture API. You can register for an app key here. Note you will have to log in to create an App Key.
SDK Installation¶
The SDK is released as a NuGet package named SocketMobile.Capture. The NuGet package lies in the public NuGet Manager.
The CaptureSDK NuGet depends on JSON NuGet from Newtonsoft that will get installed as well.
Configure and Pair Socket Mobile Devices¶
The scanner can be configured and paired following the Setup page of the Socket Mobile Companion app. Below adds more details to the setup.
Configuring the Scanner¶
By default, the factory settings of the Socket Cordless Scanners are set to Basic Mode (keyboard emulation: HID). In order to use the scanner with an application using CaptureSDK, the scanner must be configured in Application Mode (Bluetooth Serial Port Profile: SPP).
The following barcode will configure your scanner into Application Mode:
Note
This configuration barcode is persistent across power cycling the scanner and needs to be scanned only once. The scanner will stay in that mode until it is reset to its factory defaults, or until the keyboard emulation Basic Mode(HID) barcode is scanned.
Connecting/Pairing the Scanner to the Host¶
The process of doing the initial pairing of the scanner to a host PC is very simple. Make sure that there is no previous pairing saved in the host and in the scanner. On the scanner the pairing can be cleared by following these steps:
Turn on the scanner
Press the power button while pressing the scan button
wait for the scanner to turn off
A series of 3 beeps will confirm the pairing information has been deleted. If these 3 beeps are not heard, retry these steps until you hear the 3 beeps.
To connect the scanner to the host, turn it on and either scan a command barcode that contains the Host Bluetooth Address or simply go to the host Bluetooth settings, discover the scanner and pair to it.
Note
Make sure the Socket Mobile Companion software is running at that time and the scanner should automatically connect to Socket Mobile Companion software. A beep confirms when the scanner is connected and ready to be used.
Using CaptureSDK¶
The easiest way to use the CaptureSDK in your C# application is to use methods from the CaptureHelper class. Please refer to Capture Helper