.NET MAUI Android SDK
For ASR-P3xU
SDK マニュアル

Asterisk,Inc.
2024-09-17

第1版

.NET MAUI SDK for ASR-P3xU

変更履歴
No.
1

版数
第1版

変更内容
新規作成

日付
2024/09/17

1

.NET MAUI SDK for ASR-P3xU

目次

1 SDK の追加 .................................................................. 4
1.1 SDK をインポートする ...................................................... 4
1.2 権限の追加 .............................................................. 10
2 SDK の使用 ................................................................. 11
2.1 SDK のインポート ......................................................... 11
2.2 「MyAsReaderDeviceListener」デリゲートクラスを作成して、デリゲートメソッド
を実現 ...................................................................... 112.3 AsReaderP3xUMAUIManager オブジェクトを初期化 ............................. 112.4 OnStateChanged を実現 .................................................... 122.5 OnReadTag を実現 ......................................................... 122.6 OnKeyEvent を実現 ........................................................ 122.7 OnActionChanged を実現 ................................................... 122.8 OnAccessResult を実現 .................................................... 122.9 USB 接続 ................................................................. 122.10 RFID スキャン開始 ....................................................... 122.11 RFID スキャン停止 ....................................................... 13
2.12 切断 ................................................................... 133 ビルドする.NET バージョンの変更 ............................................. 14
4 API の使用 ................................................................. 172

.NET MAUI SDK for ASR-P3xU
この文書の説明には、下記開発環境を使用しています。
開発環境：
・.NET バージョン：.NET 7.0
・Visual Studio: Visual Studio Community 2022 for Mac 17.6.7 (build 417)
・Android Studio：
Android Studio Giraffe | 2022.3.1 Patch 4
Build #AI-223.8836.35.2231.11090377, built on November 14, 2023

3

.NET MAUI SDK for ASR-P3xU

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

4

.NET MAUI SDK for ASR-P3xU
3. 「.NET MAUI App」を選択します。

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

5

.NET MAUI SDK for ASR-P3xU
5. アプリ名とロケーションを作成します。

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

6

.NET MAUI SDK for ASR-P3xU
7. 下図赤枠内の「<Target Frameworks>」で使用しないフレームを削除します。
（マルチプラットフォームをご使用される場合、7 の操作を行う必要はございません。）

8. 削除すると、下図の赤枠内のようになります。

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

7

.NET MAUI SDK for ASR-P3xU
10. Dependencies -> 右クリック -> Add Project Reference…を選択します。

11. その後、「.NET Assembly」（下図 1）を選び、「Browse…」（下図 2）を選択します。

8

.NET MAUI SDK for ASR-P3xU
12. 「AsReaderP3xUAndroidSDK.dll」（下図 1）を選択し「Open」ボタン（下図2）を選択します。

13. 「References」ウィンドウ内のリストにある「AsReaderP3xUAndroidSDK.dll」左側のチェックボックスを選択、「Select」を選択します。

9

.NET MAUI SDK for ASR-P3xU
14. 「Assemblies」に「AsReaderP3xUAndroidSDK」（下図 1）が表示されます。

15. マルチプラットフォームを使用する場合、下記内容を追記して下さい。

1.2 権限の追加
AndroidManifest.xml に権限を追加します。

10

.NET MAUI SDK for ASR-P3xU

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

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

2.3 AsReaderP3xUMAUIManager オブジェクトを初期化

11

.NET MAUI SDK for ASR-P3xU

2.4 OnStateChanged を実現

2.5 OnReadTag を実現

2.6 OnKeyEvent を実現

2.7 OnActionChanged を実現

2.8 OnAccessResult を実現

2.9 USB 接続

mDevice：AsReaderP3xUDevice クラスのインスタンスオブジェクト
mAsReaderP3xU：AsReaderP3xU クラスのインスタンスオブジェクト
usbCdc：AsReaderP3xUDevice クラスのインスタンスオブジェクト

2.10 RFID スキャン開始

12

.NET MAUI SDK for ASR-P3xU

2.11 RFID スキャン停止

2.12 切断13

.NET MAUI SDK for ASR-P3xU

3 ビルドする.NET バージョンの変更「.NET 7.0」を「.NET 8.0」に変更する方法です。
1. プロジェクトを右クリック->プロパティ

14

.NET MAUI SDK for ASR-P3xU
2. 全般->ターゲット.NET ランタイムを「.NET 8.0」に変更します。

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

15

.NET MAUI SDK for ASR-P3xU
4. 以下の修正を行い、ファイルを保存。

<TargetFramework>net7.0-android</TargetFramework>↓<TargetFramework>net8.0-android</TargetFramework>以下の配置を追加します。
<UseMaui>true</UseMaui><MauiVersion>8.0.3</MauiVersion><SkipValidateMauiImplicitPackageReferences>true</SkipValidateMauiImplicitP
ackageReferences>
5.改めてプロジェクトをローディングします。
※ビルドした時に作成されるアプリは使用したバージョンツールでのみ使用できます。
例えば、「.NET 8.0」でビルドした場合、そのツールでのみご使用でき、「.NET 7.0」や「.NET 9.0」ではご使用できません。

16

.NET MAUI SDK for ASR-P3xU

4 API の使用
API の使用について、Android の SDK マニュアルを参照してください。
「AsReaderP3xU_SDK_Reference_Guide_for_Android_Developers_JP_x_x」

17