概要
[コンテンツ プロバイダの使用] オプションを使用すると、アプリケーションで DataWedge のコンテンツ プロバイダを利用して、画像 (主に署名読み取りや NextGen SimulScan を使用してスキャンした画像) などの 500KB を超えるファイルからスキャンしたデータを取得できます。コンテンツ プロバイダは、アプリ間で共有できるようにデータをカプセル化する Android アプリ コンポーネントです。
注:
- インテント出力のコンポーネント情報でアプリケーションが指定されている場合は、指定されたアプリケーションのみが DataWedge コンテンツ プロバイダーを照会できます。
- DataWedge のコンテンツ プロバイダは、Android
ContentProviderクラス オブジェクトを通じて一度に 768KB (786,432 バイト) の未加工データしか送信できません。スキャンしたデータがこの制限を超えると、残りのデータは、同じサイズ制限の後続のContentProviderオブジェクト (URI は最初のContentProviderに含まれている) で送信されます。URI とは、コンテンツ プロバイダに問い合わせてデータを取得するために使用される文字列のことで、プロバイダとパスが含まれています。ContentProviderを個別の部分に分割するこのプロセスは、未加工のスキャン データが実際のファイル サイズに達するまで繰り返されます。次に、クライアント アプリケーションで、すべてのContentProvidersからの未加工データを連結して、最終的な完全な未加工データ オブジェクトを byte[] 形式で再構築する必要があります。
要件
- DataWedge バージョン 8.0 以降 (バージョンを検索)
- モバイル コンピュータの内蔵カメラ
- TC21 や TC26 などの Zebra Professional シリーズのデバイスの場合Mobility DNA Enterprise ライセンスが必要です。
パッケージの表示
重要: Android 11 (API 30) によろパッケージの表示が制限されているため、Android 11 以降を対象とする DataWedge アプリは、AndroidManifest.xml ファイルに次の <queries> 要素を含める必要があります。
<queries><package android:name="com.symbol.datawedge" /></queries>コンテンツ プロバイダ
コンテンツ プロバイダを使用してデータを取得するには、次のセクションの手順に従います。
1.Android マニフェストを変更
次の権限を Android アプリケーションのマニフェストに追加して、そのアプリケーションから DataWedge コンテンツ プロバイダにアクセスできるようにする必要があります。
<uses-permission android:name="com.symbol.datawedge.permission.contentprovider" />2.コンテンツ プロバイダを有効にする
次のオプションのいずれかを選択して、コンテンツ プロバイダを有効にします。
2a.DataWedge UI を介したコンテンツ プロバイダの有効化
DataWedge UI を介してコンテンツ プロバイダ オプションを有効にするには、DataWedge プロファイルの [インテント出力] セクションに移動し、[インテント出力] を有効にします。
インテント出力
次に、[コンテンツ プロバイダの使用] オプションを有効にします。
コンテンツ プロバイダの使用
2bDataWedge インテント API を介したコンテンツ プロバイダの有効化
DataWedge Intent API を介してコンテンツ プロバイダ オプションを有効にするには、インテント キー intent_use_content_provider を、サポートされている値 true または false とともに使用します。
次のサンプル コードでは、プロファイル Profile009 のコンテンツ プロバイダを有効にする方法を示しています。
Bundle bMain = new Bundle(); ArrayList<Bundle> bundlePluginConfig = new ArrayList<>(); Bundle bConfigIntent = new Bundle(); Bundle bParamsIntent = new Bundle(); bParamsIntent.putString("intent_output_enabled", "true"); bParamsIntent.putString("intent_use_content_provider", "true"); bConfigIntent.putString("PLUGIN_NAME", "INTENT"); bConfigIntent.putString("RESET_CONFIG", "true"); bConfigIntent.putBundle("PARAM_LIST", bParamsIntent); bundlePluginConfig.add(bConfigIntent); bMain.putParcelableArrayList("PLUGIN_CONFIG", bundlePluginConfig); bMain.putString("PROFILE_NAME", "Profile009"); bMain.putString("PROFILE_ENABLED", "true"); bMain.putString("CONFIG_MODE", "CREATE_IF_NOT_EXIST"); Intent iSetConfig = new Intent(); iSetConfig.setAction("com.symbol.datawedge.api.ACTION"); iSetConfig.putExtra("com.symbol.datawedge.api.SET_CONFIG", bMain); iSetConfig.putExtra("SEND_RESULT", "LAST_RESULT"); this.sendBroadcast(iSetConfig);3.コンテンツ プロバイダを使用してインテント出力を処理
コンテンツ プロバイダを使用するように構成されている場合は、最初に、インテント出力プラグインでの構成方法に基づいてスキャン データ インテントが送信されます。
インテント エクストラには、DataWedge コンテンツ プロバイダの URI が含まれています。アプリケーションでは、コンテンツ プロバイダ URI を使用し、ContentResolver によりデータを Cursor オブジェクトに問い合わせる必要があります。
パラメータ
署名の有無ステータス - ドキュメント キャプチャ中に手書きの署名の有無を確認する必要がある場合は、既存のコンテンツ プロバイダ カーソルを通じて署名の有無ステータス パラメータが公開されます。これにより、署名が存在するかどうか、署名の有無ステータスがサポートされているかどうか、または署名の有無ステータスが要求されなかったかどうかが返されます。ドキュメント キャプチャ テンプレートを作成または編集するときは、署名の有無ステータスを要求する必要があります。
| カーソル列名 | 列の値 |
|---|---|
| field_signature_status | -2 – 基盤となるスキャナ フレームワークで署名の有無ステータスがサポートされていない -1 – 署名の有無ステータスが要求されていない 0 – 署名が存在しない 1 – 署名が存在する |
サンプル コード
NextGen SimulScan でスキャン データを処理
次のサンプル コードでは、NextGen SimulScan を使用してスキャン データを処理する方法を示します。
public class MainActivity extends AppCompatActivity { public static final String DATA_NEXT_URI = "next_data_uri"; public static final String FULL_DATA_SIZE = "full_data_size"; public static final String RAW_DATA_SIZE = "data_buffer_size"; public static final String DECODE_DATA_EXTRA = "com.symbol.datawedge.decode_data"; public static final String INTENT_OUTPUT_ACTION = "com.symbol.genericdata.INTENT_OUTPUT"; public static final String LABEL_TYPE_SIGNATURE = "LABEL-TYPE-SIGNATURE"; public static final String FIELD_DATA_URI = "com.symbol.datawedge.field_data_uri"; public static final String DECODED_MODE = "com.symbol.datawedge.decoded_mode"; public static final String DATA_TAG = "com.symbol.datawedge.data"; public static final String LABEL_TYPE = "label_type"; public static final String FIELD_LABEL_TYPE = "field_label_type"; public static final String DATA_STRING = "field_string_data"; public static final String DECODE_DATA = "field_raw_data"; public static final String IMAGE_WIDTH_TAG = "field_image_width"; public static final String IMAGE_HEIGHT_TAG = "field_image_height"; public static final String SINGLE_DECODE_MODE = "single_decode"; public static final String MULTIPLE_DECODE_MODE = "multiple_decode"; public static final String STRING_DATA_KEY = "com.symbol.datawedge.data_string"; public static final String LABEL_TYPE_TAG = "com.symbol.datawedge.label_type"; public static final String STRING_DATA_KEY_SINGLE_BARCODE = "data_string"; private BroadcastReceiver myBroadcastReceiver = new BroadcastReceiver() { @Override public void onReceive(final Context context, final Intent intent) { try { String action = intent.getAction(); Bundle extras = intent.getExtras(); /* ###### Processing scanned data from Intent output [Start] ###### */ if (action.equals(INTENT_OUTPUT_ACTION)) { Thread dataProcessingThrad = new Thread(new Runnable() { @Override public void run() { Bundle data = intent.getExtras(); if (data != null) { String decodedMode = data.getString(DECODED_MODE); /* ###### Processing scanned data when ScanningMode is set as "Single" [Start] ###### */ if (decodedMode.equals(SINGLE_DECODE_MODE)) { processSingleDecode(data); } /* ###### Processing scanned data when ScanningMode is set as "Single" [Finish] ###### */ /* ###### Processing scanned data when ScanningMode is set as "SimulScan" [Start] ###### */ else if (decodedMode.equals(MULTIPLE_DECODE_MODE)) { processMultipleDecode(data); } /* ###### Processing scanned data when ScanningMode is set as "SimulScan" [Finish] ###### */ } } }); dataProcessingThrad.start(); } /* ###### Processing scanned data from Intent output [Finish] ###### */ } catch (Exception ex) { Toast.makeText(context, ex.getMessage(), Toast.LENGTH_SHORT).show(); } } }; private void processSingleDecode(Bundle data) { String decodeDataUri = data.getString(DECODE_DATA_EXTRA); String barcodeData = ""; //Check if the data coming through the content provider. if(decodeDataUri != null) { //Data is coming through the content provider, using a Cursor object to extract data Cursor cursor = getContentResolver() .query(Uri.parse(decodeDataUri), null, null, null); if (cursor != null) { cursor.moveToFirst(); String labelType = cursor .getString(cursor.getColumnIndex(LABEL_TYPE)); String dataString = cursor .getString(cursor.getColumnIndex(STRING_DATA_KEY_SINGLE_BARCODE)); barcodeData += "\nLabel type: " + labelType; barcodeData += "\nString data: " + dataString; } } else { //Data is coming through the Intent bundle itself String labelType = data.getString(LABEL_TYPE_TAG); String dataString = data.getString(STRING_DATA_KEY); barcodeData += "\nLabel type: " + labelType; barcodeData += "\nString data: " + dataString; } TextView txtBarcodeData = new TextView(getApplicationContext()); txtBarcodeData.setText(barcodeData); showInUI(txtBarcodeData, null); updateStatus("Data processing successful"); } private void processMultipleDecode(Bundle data) { ArrayList<Bundle> fields = data.getParcelableArrayList(DATA_TAG); if(fields == null) //Content provider is not enabled in Intent Output plugin or Scanning mode is not selected as "SimulScan" { updateStatus("Content provider is not enabled in Intent Output plugin " + "or Scanning mode is not selected as \"SimulScan\".\nPlease check and try again"); return; } //Iterate through each field for (Bundle field : fields) { String decodeDataUri = field.getString(FIELD_DATA_URI); Cursor cursor = null; if(decodeDataUri != null) cursor = getContentResolver().query(Uri.parse(decodeDataUri), null, null, null); if (cursor != null) { int imgWidth = 0; int imgHeight = 0; cursor.moveToFirst(); String strResultStatusData = ""; String labelType = cursor. getString(cursor.getColumnIndex(FIELD_LABEL_TYPE)); strResultStatusData += "\nLabel type: " + labelType; if (labelType.equals(LABEL_TYPE_SIGNATURE)) { strResultStatusData += "\nImage data: "; imgWidth = cursor.getInt(cursor.getColumnIndex(IMAGE_WIDTH_TAG)); imgHeight = cursor.getInt(cursor.getColumnIndex(IMAGE_HEIGHT_TAG)); } else { String dataString = cursor .getString(cursor.getColumnIndex(DATA_STRING)); strResultStatusData += "\nString data: " + dataString; } String nextURI = cursor.getString(cursor.getColumnIndex(DATA_NEXT_URI)); byte[] binaryData = null; if (nextURI.isEmpty()) { //No data chunks. All data are available in one chunk binaryData = cursor.getBlob(cursor.getColumnIndex(DECODE_DATA)); } else { try { ByteArrayOutputStream baos = new ByteArrayOutputStream(); final String fullDataSize = cursor .getString(cursor.getColumnIndex(FULL_DATA_SIZE)); int bufferSize = cursor.getInt(cursor .getColumnIndex(RAW_DATA_SIZE)); baos.write(cursor.getBlob(cursor .getColumnIndex(DECODE_DATA))); //Read the first chunk from initial set while (!nextURI.isEmpty()) { Cursor imageDataCursor = getContentResolver() .query(Uri.parse(nextURI), null, null, null); if (imageDataCursor != null) { imageDataCursor.moveToFirst(); bufferSize += imageDataCursor .getInt(imageDataCursor .getColumnIndex(RAW_DATA_SIZE)); byte[] bufferData = imageDataCursor .getBlob(imageDataCursor .getColumnIndex(DECODE_DATA)); baos.write(bufferData); nextURI = imageDataCursor .getString(imageDataCursor .getColumnIndex(DATA_NEXT_URI)); } imageDataCursor.close(); updateStatus("Data being processed, please wait..\n" + bufferSize + "/" + fullDataSize + " bytes merged"); } binaryData = baos.toByteArray(); baos.close(); } catch (final Exception ex) { runOnUiThread(new Runnable() { @Override public void run() { Toast.makeText(MainActivity.this, ex.getMessage(), Toast.LENGTH_SHORT).show(); } }); } } final TextView txtBarcodeData = new TextView(getApplicationContext()); txtBarcodeData.setText(strResultStatusData); showInUI(txtBarcodeData,null); if (labelType.equals(LABEL_TYPE_SIGNATURE)) { try { //-- Creating YUV Image and Bitmap Image [Start] ByteArrayOutputStream out = new ByteArrayOutputStream(); YuvImage yuvImage = new YuvImage(binaryData, ImageFormat.NV21, imgWidth, imgHeight, null); yuvImage.compressToJpeg(new Rect(0, 0, imgWidth, imgHeight), 50, out); byte[] imageBytes = out.toByteArray(); Bitmap bmp = null; if (binaryData != null) { bmp = BitmapFactory.decodeByteArray(imageBytes, 0, imageBytes.length); } final ImageView img = new ImageView(getApplicationContext()); img.setImageBitmap(bmp); showInUI(null,img); //-- Creating YUV Image and Bitmap Image [Finish] } catch (final Exception ex) { runOnUiThread(new Runnable() { @Override public void run() { Toast.makeText(MainActivity.this, "Error: " + ex.getMessage(), Toast.LENGTH_SHORT).show(); } }); } } } } updateStatus("Data processing successful"); } void updateStatus(String status) { //Show status in UI } private void showInUI(final TextView textView, final ImageView imageView) { runOnUiThread(new Runnable() { @Override public void run() { if(textView != null) //Add text view to UI if(imageView != null) //Add image view to UI } }); } }署名読み取りサンプル コード
次のサンプル コードは、署名読み取りを使用してスキャン データを処理する方法を示しています。
public static final String BARCODE_IMAGE_FORMAT_TAG = "image_format"; public static final String BARCODE_SIGNATURE_TYPE_TAG = "signature_type"; public static final String BARCODE_IMAGE_SIZE_TAG = "image_size"; public static final String BARCODE_IMAGE_DATA_TAG = "com.symbol.datawedge.image_data"; public static final String SIGNATURE_IMAGE_DATA = "image_data"; public static final String DATA_NEXT_URI = "next_data_uri"; public static final String FULL_DATA_SIZE = "full_data_size"; public static final String RAW_DATA_SIZE = "data_buffer_size"; public static final String INTENT_OUTPUT_ACTION = "data_buffer_size"; private BroadcastReceiver broadcastReceiver = new BroadcastReceiver() { @Override public void onReceive(final Context context,final Intent intent) { try { String action = intent.getAction(); //Process scanned data from Intent output if (action.equals(INTENT_OUTPUT_ACTION)) { Bundle data = intent.getExtras(); if (data != null) { String imageDataUri = data.getString(BARCODE_IMAGE_DATA_TAG); if(imageDataUri == null) return; Cursor cursor = getContentResolver().query(Uri.parse(imageDataUri), null, null, null); if (cursor != null) { cursor.moveToFirst(); String format = cursor.getString(cursor.getColumnIndex(BARCODE_IMAGE_FORMAT_TAG)); String sigType = cursor.getString(cursor.getColumnIndex(BARCODE_SIGNATURE_TYPE_TAG)); String size = cursor.getString(cursor.getColumnIndex(BARCODE_IMAGE_SIZE_TAG)); String text = "Image format: " + format + "\n"; text += "Signature type: " + sigType + "\n"; text += "Image size: " + size + "\n"; final TextView txt = new TextView(getApplicationContext()); txt.setText(text); String nextURI = cursor.getString(cursor.getColumnIndex(DATA_NEXT_URI)); byte[] binaryData = null; if (nextURI.isEmpty()) { //No data chunks. All data are available in one chunk binaryData = cursor.getBlob(cursor.getColumnIndex(SIGNATURE_IMAGE_DATA)); } else { try { ByteArrayOutputStream baos = new ByteArrayOutputStream(); final String fullDataSize = cursor.getString(cursor.getColumnIndex(FULL_DATA_SIZE)); int bufferSize = cursor.getInt(cursor.getColumnIndex(RAW_DATA_SIZE)); baos.write(cursor.getBlob(cursor.getColumnIndex(SIGNATURE_IMAGE_DATA))); //Read the first chunk from initial set while (!nextURI.isEmpty()) { Cursor imageDataCursor = getContentResolver().query(Uri.parse(nextURI), null, null, null); if (imageDataCursor != null) { imageDataCursor.moveToFirst(); bufferSize += imageDataCursor.getInt(imageDataCursor.getColumnIndex(RAW_DATA_SIZE)); byte[] bufferData = imageDataCursor.getBlob(imageDataCursor.getColumnIndex(SIGNATURE_IMAGE_DATA)); baos.write(bufferData); nextURI = imageDataCursor.getString(imageDataCursor.getColumnIndex(DATA_NEXT_URI)); } imageDataCursor.close(); final int finalBufferSize = bufferSize; Log.d("TAG","Data being processed, please wait..\n" + finalBufferSize + "/" + fullDataSize + " bytes merged"); } binaryData = baos.toByteArray(); baos.close(); } catch (final Exception ex) { Toast.makeText(context, ex.getMessage(), Toast.LENGTH_SHORT).show(); } } Bitmap bmp = null; if (binaryData != null) { bmp = BitmapFactory.decodeByteArray(binaryData, 0, binaryData.length); } final ImageView img = new ImageView(getApplicationContext()); img.setImageBitmap(bmp); } Log.d("TAG","Data processing successful"); } } } catch (Exception ex) { Toast.makeText(context, ex.getMessage(), Toast.LENGTH_SHORT).show(); } } };関連ガイド: