StarXpand SDK for iOS / Android 開発者向けマニュアル Ver. 1.14.0

最終更新日: 2026年 9月 15日

プリンターを検索する

手順や参照先はOSによって異なります。表示するOSを選択してください。

iOS Android


プリンターを検索する処理 について、StarPRNT SDKとStarXpand SDKの構成を説明します。

両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の処理の流れは、以下の図を参照ください。

StarPRNT SDK
StarPRNT SDK
StarXpand SDK
StarXpand SDK


各APIのStarPRNT SDKとStarXpand SDKへの対応状況は、対応API一覧をご確認ください。

プリンターを検索する処理 について、StarPRNT SDKとStarXpand SDKの構成を説明します。

両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の処理の流れは、以下の図を参照ください。

StarPRNT SDK
StarPRNT SDK
StarXpand SDK
StarXpand SDK


各APIのStarPRNT SDKとStarXpand SDKへの対応状況は、対応API一覧をご確認ください。