チュートリアル - スキャンしたバーコードデータを Java で受信する方法

製品

DataWedge - 11.0

デバイス

サポートされているすべての Zebra Android デバイス

概要

このチュートリアルでは、DataWedge を使用して、スキャンしたバーコードデータをサンプルアプリケーション BasicIntent1 で Android インテントを介して受信する方法を示します。大まかな手順は、以下のとおりです。

DataWedge を構成します。入力 (バーコードスキャナ)と出力 (インテント) を設定します。
プロファイルを作成し、アプリをプロファイルに関連付けます。
アプリを実行し、バーコードをスキャンします。

このサンプルアプリケーションは、DataWedge インテント API の使用方法のデモのための教育目的専用です。

以上は、DataWedge API ではなく、Android の汎用インテントを使用した最小限のコードアプローチです。DataWedge の設定とデータキャプチャを詳細に制御するアプリを開発するには、「DataWedge API」ガイドおよび「ご使用の前に」ガイドのベストプラクティスを参照してください。

手順

DataWedge を起動します。アプリメニューで [DataWedge] をタップします。
新しいプロファイルを作成し、アプリをプロファイルに関連付けます。「新しいプロファイルの作成」の手順に従います。または、Profile0 (プロファイルが明示的に割り当てられていないすべてのアプリで使用されるデフォルトプロファイル) を使用することもできます。サンプルアプリを使用して特定のプロファイルに関連付ける場合は、アプリ名 “com.zebra.basicintent1” を選択します。
プロファイルで以下の設定が有効になっていることを確認します。
- プロファイル
- バーコード入力
- インテント出力
[インテント出力] を以下のように構成します。_ インテントアクション: com.basicintent1.ACTION
これは、DataWedge によって送信される暗黙的なインテントです。このインテントを受信するために、アプリケーションで、特定のアクションにブロードキャストレシーバを登録する必要があります。このチュートリアルで BasicIntent1 サンプルとともに使用するもの: com.basicintent1.ACTION _ インテントカテゴリ: (空白のまま) * インテント配信: ブロードキャストインテントこれらの設定の詳細については、DataWedge の「インテント出力」ガイドを参照してください。
サンプルアプリ BasicIntent1 をダウンロードし、ビルドして起動します。
バーコードをスキャンします。
スキャンしたデータが表示されます。

サンプルコードの説明

BasicIntent1 サンプルアプリのソースコードを参照してください。

DataWedge から送信されたインテントデータをアプリで確実に受信するための重要な手順がいくつかあります。

スキャンしたデータを抽出するときに使いやすいように、アプリケーションプロジェクトでいくつかの文字列を事前に定義します。インテントアクションは、サンプルアプリで「activity_intent_filter_action」として定義されています。受信時に、インテントのアクションには、DataWedge の「インテント出力」ガイドで説明しているように、スキャンデータのソース、タイプ、およびデータを指定したエクストラが含まれます。サンプルアプリの Strings.xml の内容を以下に示します。
```
    <resources>
        <string name="app_name">DW BasicIntent1</string>
        <string name="activity_intent_filter_action">com.dwbasicintent1.ACTION</string>
        <string name="datawedge_intent_key_source">com.symbol.datawedge.source</string>
        <string name="datawedge_intent_key_label_type">com.symbol.datawedge.label_type</string>
        <string name="datawedge_intent_key_data">com.symbol.datawedge.data_string</string>
    </resources>
```
ブロードキャストレシーバを登録します。DataWedge はブロードキャストインテントを送信するように構成されているため、アプリケーションでブロードキャストレシーバを登録する必要があります。これは、サンプルアプリの onCreate() メソッドで行います。 protected void onCreate(Bundle savedInstanceState) { IntentFilter filter = new IntentFilter(); filter.addCategory(Intent.CATEGORY_DEFAULT); filter.addAction(getResources().getString(R.string.activity_intent_filter_action)); registerReceiver(myBroadcastReceiver, filter); }

フィルタされるアクションは、DataWedge プロファイルに構成されたアクションと一致していることに注意してください。実稼働アプリケーションでは、効率化のために、登録/登録解除は onResume()/onPause() メソッドで実行される可能性があります。3.ブロードキャストレシーバを定義します。これは、サンプルアプリの MainActivity.java で行われます。

    private BroadcastReceiver myBroadcastReceiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            Bundle b = intent.getExtras();

            if (action.equals(getResources().getString(R.string.activity_intent_filter_action))) {
                //  Received a barcode scan
                try {
                    displayScanResult(intent, "via Broadcast");
                } catch (Exception e) {
                    //  Catch if the UI does not exist when we receive the broadcast
                }
            }
        }
    };

スキャンしたデータを抽出し、画面に表示します。これは、サンプルアプリの displayScanResult() メソッドで行われます。

    private void displayScanResult(Intent initiatingIntent, String howDataReceived)
    {
        String decodedSource = initiatingIntent.getStringExtra(getResources().getString(R.string.datawedge_intent_key_source));
        String decodedData = initiatingIntent.getStringExtra(getResources().getString(R.string.datawedge_intent_key_data));
        String decodedLabelType = initiatingIntent.getStringExtra(getResources().getString(R.string.datawedge_intent_key_label_type));

    final TextView lblScanSource = (TextView) findViewById(R.id.lblScanSource);
    final TextView lblScanData = (TextView) findViewById(R.id.lblScanData);
    final TextView lblScanLabelType = (TextView) findViewById(R.id.lblScanDecoder);

    lblScanSource.setText(decodedSource + " " + howDataReceived);
    lblScanData.setText(decodedData);
    lblScanLabelType.setText(decodedLabelType);
}

エクストラキーは、strings.xml ファイルで以前に定義されていることに注意してください。このコードは、サンプルアプリで実行したように、データを配置する UI が存在することを前提としています。

関連ガイド:

Zebra エンジニアである Darryn Campbell によるオリジナルチュートリアル
プロファイルの設定と詳細に関する DataWedge の「インテント出力」ガイド
インテントベースの関数に関する DataWedge API

チュートリアル - スキャンしたバーコード データを Java で受信する方法

製品

デバイス

概要

手順

サンプル コードの説明

チュートリアル - スキャンしたバーコードデータを Java で受信する方法

サンプルコードの説明