クイックスタート
StarXpand SDKには、プリンターの動作を試すことができるサンプルアプリが含まれています。
StarXpand SDKを使ってプリンターを制御する第一歩として、まずは以下の4つのステップに沿ってサンプルアプリをビルドし、サンプルレシートを印刷してみましょう。
Step1.
プリンターと上位端末の接続設定
プリンターを用意して、タブレットや PC と通信可能な状態にします。
プリンターのインターフェイスを選択してください。
インターフェイス
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の場合はiOSデバイスとプリンターとのペアリングは必要ありません。
プリンターの電源を入れ、プリンターと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. ペアリングが完了すると、”ペア設定済みのデバイス”にデバイス名が表示されます。
プリンターの電源を入れ、プリンターとAndroidデバイスをUSBケーブルで接続します。
Memo
Androidデバイスと通信可能なUSBポートはプリンターによって異なります。
ご利用いただくプリンターのオンラインマニュアルまたはハードウェアマニュアルにてご確認ください。
Step 2.
iOSアプリの開発環境の準備
Step 2.
Androidアプリの開発環境の準備
iOSアプリの開発環境を準備します。
Xcodeをインストールしてください。
Androidアプリの開発環境を準備します。
Android Studioをインストールしてください。
- Android Studio:
- https://developer.android.com/studio
Memo
サポートする開発環境についてはこちらをご参照ください。
Step3.
サンプルアプリのビルド
下記のコマンドを実行して、GitHubからStarXpand SDKをcloneします。
$ git clone https://github.com/star-micronics/StarXpand-SDK-iOS.git
Memo
弊社DeveloperサイトからStarXpand SDKのZIPパッケージをダウンロードすることもできます。
下記URLよりZIPパッケージを入手し、解凍してご利用ください。
https://sp-support.star-m.jp/developers/ios-sdks/
XcodeのメニューのFile → Open…からSDKサンプルアプリプロジェクトを開き、サンプルアプリをビルドします。
![](assets/img/build_ios_2.png)
下記のコマンドを実行して、GitHubからStarXpand SDKをcloneします。
$ git clone https://github.com/star-micronics/StarXpand-SDK-Android.git
Memo
弊社DeveloperサイトからStarXpand SDKのZIPパッケージをダウンロードすることもできます。
下記URLよりZIPパッケージを入手し、解凍してご利用ください。
https://sp-support.star-m.jp/developers/android-sdks/
Android StudioのメニューのFile → Open…SDKサンプルアプリプロジェクトを開き、サンプルアプリをビルドします。
![](assets/img/build_android_2.png)
Step4.
サンプルレシートの印刷
ビルドに成功すると、印刷画面のサンプルアプリが起動します。
最初にプリンターを検索します。 Discovery をタップしてください。
最初にプリンターを検索します。[ DISCOVERY ] をタップしてください。
![](assets/img/ios_Step4-1.png)
![](assets/img/android_Step4-1.png)
Interface を選択して Discovery をタップすると、タブレットが接続可能なプリンターが表示されます。
”:” 以降の文字列がプリンターの識別子(Identifier)です。
次の手順で接続先プリンターの指定に利用しますので、コピーしておいてください。
![](assets/img/ios_Step4-2.png)
Interface を選択して [ DISCOVERY ] をタップすると、タブレットが接続可能なプリンターが表示されます。
”:” 以降の文字列がプリンターの識別子(Identifier)です。
次の手順で接続先プリンターの指定に利用しますので、メモしておいてください。
![](assets/img/android_Step4-2.png)
最後にサンプルレシートの印刷を行います。
前の画面に戻り Printing をタップしてください。
Identifier 入力欄にDiscoveryの画面でコピーしたプリンターの 識別子(Identifier) を入力して Print をタップします。
![](assets/img/ios_Step4-3.png)
最後にサンプルレシートの印刷を行います。
前の画面に戻り [ PRINTING ] をタップしてください。
Identifier 入力欄にDiscoveryの画面でメモしたプリンターの 識別子(Identifier) を入力して [ PRINT ] ボタンを押します。
![](assets/img/android_Step4-3.png)
サンプルレシートは印刷されましたか?
次はお客様のアプリからプリンターを利用してみましょう。APIご利用の手引きを参考にしてください。