MAUI For AsReaderDockSDK4
SDK マニュアル V1.0

Asterisk,Inc.
2024-01-18

変更履歴
No.

バージョン

変更内容

⽇付

11.0

新規作成

2024/01/18

1

⽬ 次
1 SDK の追加 ..........................................................................................................................4
1.1 SDK をインポートする ........................................................................................................4
1.2 プロトコルの追加 ............................................................................................................12
1.3 権限の追加 ..................................................................................................................121.3.1 Bluetooth の使⽤権限を追加する ..........................................................................122 SDK の使⽤ ........................................................................................................................13
2.1 SDK のインポート ...........................................................................................................13
2.2 「AsReaderDevice」デリゲートクラスを作成して、デリゲートメソッドを実現する ......................14
2.3 AsReaderBarcodeDevice オブジェクトを初期化する ......................................................15
2.4 Plugged を実現する .....................................................................................................15
2.5 ReaderConnected を実現する.....................................................................................15
2.6 ReceivedScanData を実現する ...................................................................................16
2.7 電源 On ......................................................................................................................16
2.8 スキャン開始 .................................................................................................................16
2.9 スキャン停⽌ .................................................................................................................17
2.10 電源 Off ....................................................................................................................17
3 AsReader Dock SDK4 MAUI .Net の変更 ...................................................................18
4 Api の使⽤ ..........................................................................................................................212

アプリケーションを作成する開発環境は、以下のものを推奨します。
開発環境︓.Net バージョン︓.Net 7.0
Visual Studio: Visual Studio Community 2022 for Mac 17.6.7 (build 417)
Xcode︓15.0.1
この⽂書の説明には、上記開発環境を使⽤しています。

3

1 SDK の追加
1.1 SDK をインポートする
1. AsReaderBLESDK と AsReaderSDK4 をローカルにダウンロードします。
2. プロジェクトを新規作成します。

4

3. 「.NET MAUI APP」を選択します。

4. 「.NET 7.0」を選択します。

55. アプリ名とロケーションを作成します。

6. 「AsReaderSDK4MAUIDemo.csproj」を右クリックして、TextEdit で開きます。

6

7. 下図⾚枠内（net70-iOS）で、必要としない全てのフレームを削除します。（iOS プラットフォームのみ使⽤した場合の操作です。マルチプラットフォームの場合、この操作は不要です。）

8. 削除完了後は下図の通りです。

7

9. ローカルにダウンロードした AsReaderBLESDK と AsReaderSDK4 をプロジェクトフォルダーにコピーします。

10. Dependencies -> 右クリック -> Add Project Reference…

811. ポップアップしたウィンドウに「.Net Assembly」（下図 1）をクリックして、「Browse…」（下図 2）を選択します。

912. ポップアップしたウィンドウに「AsReaderBLESDK.IOS.dll」と「AsReaderSDK4.IOS.dll」（下図 1）を選択して、「Open」ボタン（下図 2）をクリックします。

1013. 「References」ウィンドウのリストにある「AsReaderBLESDK.IOS.dll」と「AsReaderSDK4.IOS.dll」左側のチェックボックスを選択して、「Select」ボタンをクリックします。

14. 追加後、「Assemblies」に「AsReaderBLESDK.IOS」と「AsReaderSDK4.IOS」（下図 1）が表⽰されます。

1115. マルチプラットフォームを使⽤する場合、以下の操作を⾏ってください。

1.2 プロトコルの追加
Info.plist にサポートしているプロトコルを追加します。

1.3 権限の追加
1.3.1 Bluetooth の使⽤権限を追加する
Info.plist に Bluetooth の使⽤権限を追加します。

12

2 SDK の使⽤
2.1 SDK のインポート
アプリケーションの SDK を使⽤するクラスに using ⽂で SDK をインポートします。

13

2.2 「AsReaderDevice」デリゲートクラスを作成して、デリゲートメソッドを実現する※Platforms の iOS フォルダに作成することをお勧めします。

14

2.3 AsReaderBarcodeDevice オブジェクトを初期化する

2.4 Plugged を実現する

2.5 ReaderConnected を実現する

15

2.6 ReceivedScanData を実現する

2.7 電源 On
デリゲート Plugged からコールバック成功の結果を受け取り、電源 On のメソッドを呼び出します。

2.8 スキャン開始
スキャン結果はデリゲート ReceivedScanData にコールバックされます。

16

2.9 スキャン停⽌

2.10 電源 Off

17

3 AsReader Dock SDK4 MAUI .Net の変更
デモアプリはビルドした時に使⽤したバージョンのツールでしか使えません。
例︓「.net MAUI 8」でビルドした場合、「.net MAUI 8」だけで使えます。「.net MAUI 7」や「.net MAUI 9」で使えません。
以下は例として「.net MAUI 7」を「.net MAUI 8」に変更する⽅法です。
1. プロジェクトを右クリック->プロパティ18

2. 全般->ターゲット.NET ランタイムに「.NET 8.0」を選択します。

3. プロジェクトフォルダに.csproj を選択して、editor で開きます。

4. 以下の修正を⾏います。

<TargetFramework>net7.0-ios</TargetFramework>↓<TargetFramework>net8.0-ios</TargetFramework>19以下の配置を追加します。
<UseMaui>true</UseMaui><MauiVersion>8.0.3</MauiVersion><SkipValidateMauiImplicitPackageReferences>true</SkipValidateMauiImplici
tPackageReferences>
修正後にファイルを保存します。
4.保存後に改めてプロジェクトをローディングします。
5.以下のプロジェクトは、全て上記１〜４の通りに修正する必要があります。

20

4 Api の使⽤
Api の使⽤について、Objective-C の SDK マニュアルを参照してください。
「AsReaderDockSDK4_SDK_Reference_Guide_ObjectiveC_JP_1_13」

21