クイックスタート
StarXpand SDKには、プリンターの動作を試すことができるサンプルアプリが含まれています。
StarXpand SDKを使ってプリンターを制御する第一歩として、まずは以下の４つのステップに沿ってサンプルアプリをビルドし、サンプルレシートを印刷してみましょう。
Step1.
プリンターとホストデバイスの接続設定
プリンターを用意して、タブレットや PC と通信可能な状態にします。
OS とプリンターのインターフェイスを選択してください。
OS
インターフェイス
LAN Bluetooth Bluetooth Low Energy USB
通信設定の手順
Bluetoothで接続する場合、はじめにiOSデバイスとプリンターのペアリングが必要です。
- 1. プリンターの電源を入れます。
Memo
TSP650II、TSP650IISK、TSP700II、TSP800II、SP700をお使いの場合は、電源投入後に本体背面のPAIRボタンを長押してLEDを緑点滅状態にしてください。 - 2. iOSの「設定」を開き [ Bluetooth ] を選択します。
- 3. Bluetoothをオンにします。
- 4. ペアリングを行うデバイス名を選択します。
Memo
プリンターの種類によってペアリング方式が異なります。指示が表示されない場合は操作不要です。
・PIN入力を求められた場合、PINを入力してください。（工場出荷時設定は 1234 です。）
・ペアリングコードがホストデバイスに表示された場合、そのペアリングコードがプリンターからも印字されていることを確認してください。
確認後、プリンターのフィードボタンを押し、ホストデバイスの確認に対して承認してください。 - 5. ペアリングが完了すると、デバイス名の横に”接続済み”と表示されます。
プリンターとiOSデバイスを同じネットワーク（セグメント）に接続します。
- 1. iOSの「設定」を開き [ Wi-Fi ] を選択します。
- 2. Wi-Fiをオンにします。
- 3. 使用するネットワークを選択して、iOSデバイスを接続します。
- 4. プリンターの電源を入れます。
- 5. プリンターにLANケーブルを接続して、プリンターとiOSデバイスを同じネットワーク（同一セグメント）に接続します。
Memo
Star POSプリンターの工場出荷時の初期設定は”DHCP：有効”です。
DHCPのない環境の場合、こちらのリンクの「対応OS・環境一覧 > ユーティリティ一覧」より、「イーサネットプリンター利用手引き」をご参照のうえ、プリンターに固定IPアドレスを設定してください。
プリンターとデバイスをBluetooth Low Energyで接続します。
- 1. プリンターの電源を入れます。
- 2. iOSデバイスのBluetoothをオンにします。
Memo
対応モデルによってiOSデバイスとプリンターのペアリングが必要となります。
ペアリングはAPIライブラリにて行われるため、デバイスの設定画面からのペアリング操作は不要です。
詳細は[APIご利用の手引き - ペアリングを行う]を参照ください。
プリンターの電源を入れ、プリンターとiOSデバイスをUSBケーブルまたはLightningケーブルで接続します。
Memo
iOSデバイスと通信可能なUSBポートはプリンターによって異なります。
ご利用いただくプリンターのオンラインマニュアルまたはハードウェアマニュアルにてご確認ください。
プリンターとAndroidデバイスを同じネットワーク（セグメント）に接続します。
- 1. Androidの設定から ネットワークとインターネット > インターネット を選択します。
- 2. Wi-Fiをオンにし、使用するネットワークを選択してAndroidデバイスを接続します。
- 3. プリンターの電源を入れます。
- 4. プリンターにLANケーブルを接続して、プリンターとAndroidデバイスを同じネットワーク（同一セグメント）に接続します。
Memo
Star POSプリンターの工場出荷時の初期設定は”DHCP：有効”です。
DHCPのない環境の場合、こちらのリンクの「対応OS・環境一覧 > ユーティリティ一覧」より、「イーサネットプリンター利用手引き」をご参照のうえ、プリンターに固定IPアドレスを設定してください。
Bluetoothで接続する場合、はじめにAndroidデバイスとプリンターのペアリングが必要です。
- 1. プリンターの電源を入れます。
Memo
TSP650II、TSP650IISK、TSP700II、TSP800II、SP700をお使いの場合は、電源投入後に本体背面のPAIRボタンを長押してLEDを緑点滅状態にしてください。 - 2. Androidデバイスの Bluetooth をオンにします。
- 3. Androidの設定から 接続済みのデバイス > +新しいデバイスとペア設定 を選択します。
- 4. ペアリングを行うデバイス名を選択します。
Memo
プリンターの種類によってペアリング方式が異なります。指示が表示されない場合は操作不要です。
・PIN入力を求められた場合、PINを入力してください。（工場出荷時設定は 1234 です。）
・ペアリングコードがホストデバイスに表示された場合、そのペアリングコードがプリンターからも印字されていることを確認してください。
確認ができた後、プリンターのフィードボタンを押し、ホストデバイスの確認に対して承認してください。 - 5. ペアリングが完了すると、”ペア設定済みのデバイス”にデバイス名が表示されます。
プリンターとデバイスをBluetooth Low Energyで接続します。
- 1. プリンターの電源を入れます。
- 2. AndroidデバイスのBluetoothをオンにします。
Memo
対応モデルによってAndroidデバイスとプリンターのペアリングが必要となります。
ペアリングはAPIライブラリにて行われるため、デバイスの設定画面からのペアリング操作は不要です。
詳細は[APIご利用の手引き - ペアリングを行う]を参照ください。
プリンターの電源を入れ、プリンターとAndroidデバイスをUSBケーブルで接続します。
Memo
Androidデバイスと通信可能なUSBポートはプリンターによって異なります。
ご利用いただくプリンターのオンラインマニュアルまたはハードウェアマニュアルにてご確認ください。
プリンターとWindowsデバイスを同じネットワーク（セグメント）に接続します。
- 1. タスクバーのネットワークアイコンをクリックしてWi-Fiをオンにして、使用するネットワークに接続します。
- 2. プリンターの電源を入れます。
- 3. プリンターにLANケーブルを接続して、プリンターとWindowsデバイスを同じネットワーク（同一セグメント）に接続します。
Memo
Star POSプリンターの工場出荷時の初期設定は”DHCP：有効”です。
DHCPのない環境の場合、こちらのリンクの「対応OS・環境一覧 > ユーティリティ一覧」より、「イーサネットプリンター利用手引き」をご参照のうえ、プリンターに固定IPアドレスを設定してください。
プリンターとデバイスをBluetooth Low Energyで接続します。
- 1. プリンターの電源を入れます。
- 2. WindowsデバイスのBluetoothをオンにします。
Memo
対応モデルによってWindowsデバイスとプリンターのペアリングが必要となります。
ペアリングはAPIライブラリにて行われるため、デバイスの設定画面からのペアリング操作は不要です。
詳細は[APIご利用の手引き - ペアリングを行う]を参照ください。
Bluetoothで接続する場合、Windowsデバイスとプリンターのペアリングが必要です。
- 1. プリンターの電源を入れます。
Memo
TSP650II、TSP650IISK、TSP700II、TSP800II、SP700をお使いの場合は、電源投入後に本体背面のPAIRボタンを長押してLEDを緑点滅状態にしてください。 - 2. Windowsデバイスの Bluetooth をオンにします。
- 3. Windowsの設定から 接続済みのデバイス > +新しいデバイスとペア設定 を選択します。
- 4. ペアリングを行うデバイス名を選択します。
Memo
プリンターの種類によってペアリング方式が異なります。指示が表示されない場合は操作不要です。
・PIN入力を求められた場合、PINを入力してください。（工場出荷時設定は 1234 です。）
・ペアリングコードがホストデバイスに表示された場合、そのペアリングコードがプリンターからも印字されていることを確認してください。
確認ができた後、プリンターのフィードボタンを押し、ホストデバイスの確認に対して承認してください。 - 5. ペアリングが完了すると、”ペア設定済みのデバイス”にデバイス名が表示されます。
Step 2.
ReactNative アプリの開発環境構築
ReactNativeアプリの開発環境を準備します。
https://reactnative.dev/docs/environment-setup
Memo
サポートする開発環境についてはこちらをご参照ください。
Step3.
サンプルアプリのビルド
下記のコマンドを実行して、GitHubからcloneしたStarXpand SDKに含まれるサンプルアプリをビルドします。
Memo https://sp-support.star-m.jp/developers/cross-platform-sdks/
弊社DeveloperサイトからStarXpand SDKのZIPパッケージをダウンロードすることもできます。
下記URLよりZIPパッケージを入手し、解凍してご利用ください。
各 OS のコマンド
$ git clone https://github.com/star-micronics/react-native-star-io10.git $ cd react-native-star-io10/example $ yarn install $ cd ios $ pod update $ cd .. $ npx react-native run-ios
$ git clone https://github.com/star-micronics/react-native-star-io10.git $ cd react-native-star-io10/example $ yarn install $ npx react-native run-android
$ git clone https://github.com/star-micronics/react-native-star-io10.git $ cd react-native-star-io10/example $ yarn install $ npx react-native run-windows
Step4.
サンプルレシートの印刷
ビルドに成功すると、印刷画面のサンプルアプリが起動します。
最初にプリンターを検索します。
以下のコマンドを実行して、検索画面のサンプルに切り替えてください。
$ cp samples/discovery/App.tsx ./
Interfaceを選択して [ Discovery ] を押してください。
タブレットやPCが接続可能なプリンターが表示されます。
":" 以降の文字列が ”Identifier” ですので、コピーまたはメモしておいてください。
次にサンプルレシートの印刷を行います。
以下のコマンドを実行して、再度印刷画面のサンプルに切り替えてください。
$ cp samples/printing/App.tsx ./
Identifier 入力欄に Discovery の画面でコピーしたプリンターの識別子（Identifier）を入力して [ Print ] を押します。
プリンターと初めての接続時にペアリング要求の画面が表示され、パスキーの入力が必要です。入力時間には制限があるため、モデルごとに添付されているマニュアルを参考に、パスキーを事前にご確認ください。モデルによってパスキーの設定値は異なります。初回のペアリングに成功すれば次回以降は行われません。お使いのデバイスのBluetooth設定を初期化した場合やプリンターを交換した際には、再度ペアリングが必要となります。
サンプルレシートは印刷されましたか？
次はお客様のアプリからプリンターを利用してみましょう。APIご利用の手引きを参考にしてください。