プリンターを検索する
両SDKの違いを確認しStarXpand SDKへの移行を行ってください。
StarPRNT SDK
SMPortクラスの同期API、searchPrinter()を使用して検索を行います。
searchPrinter()は一定時間検索を行った後、検出したプリンターの配列を戻り値として返します。
プリンターを使用する際は、戻り値からportNameを取得し、SMPort.getPort()メソッドでSMPortインスタンスを作成してください。
検索するインターフェイスは"BT:"、"TCP:"などの文字列で指定します。
検索時間はインターフェイスごとに固定です。
サンプルコード(GitHub)
StarXpand SDK
StarDeviceDiscoveryManagerクラスの非同期API、startDiscovery()メソッドで検索を開始します。
検索は、指定した検索時間が経過すると自動的に終了します。途中で検索を終了するには stopDiscovery()メソッドを呼び出します。
プリンターの検索結果や検索終了は、StarDeviceDiscoveryManagerDelegateプロトコルのメソッドを通じて通知されます。
検索結果は、そのまま使用可能なStarPrinterインスタンスとして取得できます。
検索するインターフェイスはInterfaceTypeのenum値で指定します。
検索時間は任意の値を指定することができます。
サンプルコード(GitHub)
両SDKの比較
| StarPRNT SDK | StarXpand SDK | |
|---|---|---|
| 非同期API | 非対応 | 非同期APIのため、検索中に別の処理を実行可能 |
| 検索インターフェイス | 文字列 | enum値 |
| 検索時間 | 固定値 | 任意に設定可能 |
| 戻り値 | プリンター情報の配列 | StarPrinterインスタンス |
処理の流れ (シーケンス図)
両SDKの処理の流れは、以下の図を参照ください。
各APIのStarPRNT SDKとStarXpand SDKへの対応状況は、対応API一覧をご確認ください。
両SDKの違いを確認しStarXpand SDKへの移行を行ってください。
StarPRNT SDK
StarIOPortクラスの同期API、searchPrinter()を使用して検索を行います。
searchPrinter()は一定時間検索を行った後、戻り値で検出したプリンターのPortInfoリストを返します。
プリンターを使用する際は、戻り値からportNameを取得し、StarIOPort.getPort()メソッドでStarIOPortインスタンスを作成してください。
検索するインターフェイスは"BT:"、"TCP:"などの文字列で指定します。
検索時間はインターフェイスごとに固定です。
サンプルコード(GitHub)
StarXpand SDK
StarDeviceDiscoveryManagerクラスの非同期API、startDiscovery()メソッドで検索を開始します。
検索は、指定した検索時間が経過すると自動的に終了します。途中で検索を終了するには stopDiscovery()メソッドを呼び出します。
プリンターの検索結果や検索終了は、StarDeviceDiscoveryManager.Callbackインターフェースのメソッドを通じて通知されます。
検索結果は、そのまま使用可能なStarPrinterインスタンスとして取得できます。
検索するインターフェイスはInterfaceTypeのenum値で指定します。
検索時間は任意の値を指定することができます。
サンプルコード(GitHub)
両SDKの比較
| StarPRNT SDK | StarXpand SDK | |
|---|---|---|
| 非同期API | 非対応 | 非同期APIのため、検索中に別の処理を実行可能 |
| 検索インターフェイス | 文字列 | enum値 |
| 検索時間 | 固定値 | 任意に設定可能 |
| 戻り値 | PortInfoのリスト | StarPrinterインスタンス |
処理の流れ (シーケンス図)
両SDKの処理の流れは、以下の図を参照ください。
各APIのStarPRNT SDKとStarXpand SDKへの対応状況は、対応API一覧をご確認ください。

