Intent Manager

特定のデバイスに存在する機能のみを表示するには、下の SmartDocs バーから 1 つまたは複数のフィルタを選択します。

入力フィールドには、英語のみを入力できます。

MX からのクエリは、Android 11 以降を実行している Zebra デバイスではサポートされていません。代替方法を参照してください。

StageNow - 5.10

概要

インテント CSP を使用すると、アプリケーションは Android インテントを使用して他のアプリケーションと通信できます。これにより、アプリケーション間のランタイムバインディングを遅延させる機能が提供されます。この汎用メカニズムには、送信先のアプリケーションの要件を満たすように設計をカスタマイズするための、Android インテントクラスの豊富なメソッドセットが含まれています。インテントの最も一般的な使用法は、アプリケーションのアクティビティを起動することです。

Java コードを使用して非常に複雑なインテントを作成できますが、可能なすべてのインテントをインテントで記述するのは実用的ではありません。代わりに、最も一般的なユースケース (アプリケーションのアクティビティの起動) と、他の一般的なユースケースをカバーするためにデータ項目を添付する多少の機能がサポートされています。

Android では、インテントとは実行する操作の概念の説明です。インテントは、次のいずれかの API を使用して作成および送信する必要があります。

StartActivity は、アプリケーション内でアクティビティを起動します。これは通常、連絡先名の選択など、ユーザーインタフェースの特定の機能を実行するために使用され、そのような場合は結果 (連絡先) を返します。
BroadcastIntent は、接続中の外部電源など、イベントの発生について 1 つまたは複数のリスナアプリケーションに通知します。
StartService は、サービスを開始します。このサービスは、起動したコンポーネントが破棄された後もバックグラウンドで実行され続けます。

インテントは、実行する操作とその操作を実行するために必要なデータを指定するデータ構造として定義できます。インテントには、実行する操作を入力するアクション、操作対象のデータ、および実行する操作を評価するためのさまざまなタイプの追加データ項目が含まれる場合があります。インテントは、インテントの送信方法を指定し、プライマリデータの Android アクション名、URI および MIME タイプを入力し、追加のデータ項目を添付することによって定義されます。

注: インテント機能は、非常に複雑なインテント、特に、多数の追加データ項目を必要とするインテントや、複雑なデータ型を持つインテントを作成して送信するようには設計されていません。複雑なインテントが必要な場合、Zebra では、Java アプリとして作成してパッケージ化し、シンプルなインテントを使用してそのアプリを起動することをお勧めします。

インテントタイプ

明示的なインテント

明示的なインテントは特定のアプリケーションに送信されます。要求された操作の実行を、そのアプリケーションのみに要求します。明示的なインテントは、使用可能な任意の方法を使用して送信できますが、通常、startActivity または startService メソッドを使用して、特定のアプリケーション内のアクティビティまたはサービスに送信します。

インテントでパッケージ名とクラス名が指定されている場合、パッケージ名とクラス名で指定された特定のアプリケーションにのみ送信されるため、明示的なインテントと見なされます。指定されたパッケージ名とクラス名を持つアプリケーションがインストールされていない場合、明示的なインテントは失敗します。明示的なインテントは、追加情報を入力して、要求された操作の実行方法を受信アプリケーションに指示することができますが、必須ではありません。

暗黙的なインテント

暗黙的なインテントは、操作を実行するアプリケーション (複数可) を入力しない、操作を実行する一般的な要求です。暗黙的なインテントは、使用可能ないずれかの方法を使用して送信できますが、最も一般的には、broadcastIntent を使用して、登録されている受信者の数を指定せずに操作の実行を要求します。

インテントがパッケージ名とクラス名を入力しない場合、送信先の特定のアプリケーションを入力しないため、暗黙的なインテントと見なされます。適切な登録受信者がない場合、暗黙的なインテントは失敗する可能性があります。暗黙的なインテントは、実行する操作とその実行方法を受信アプリケーションに通知するために、少なくとも一部の情報を入力する必要があります。

重要: 暗黙的なインテントは、Andriod 7.0 Nougat から始まるインテント CSP ではサポートされなくなります。明示的なインテントは、Android N 以降を実行しているデバイスでのみ使用します。

主な機能

インテントの送信方法を選択します。
- StartActivity
- BroadcastIntent
- StartService
デバイスオーナーを登録します
実行する操作の Android アクション名を入力します
プライマリデータの URI と MIME タイプを入力します
次のデータ型の追加データ項目を 5 つまで添付できます。
- 標準整数
- 文字
- 文字シーケンス
- 浮動小数点数
- 長整数
- ブール
- 短
- 倍精度浮動小数点数
- 文字列
- シングルバイト整数
キーを押すとリッスンおよび起動するようにインテントを設定します
インテントを開始するためのキーを特定します
インテントをトリガまたはキャンセルするデバイスセンサを選択します
センサステータスを取得するために送信する追加の名前を入力します

アクション

インテントにより、他のアプリケーションで呼び出されるアクションを入力するために使用されます。

次の場合に表示: モードが [即時] の場合

パラメータ名: アクション

オプション	名前	説明	要件
1	StartActivity	startActivity を使用してインテントを送信し、アプリケーション内でアクティビティを呼び出します。	MX: 4.1+ Android API: 1+
2	StartService	startService を使用してインテントを送信し、アプリケーション内でバックグラウンドサービスの操作を開始します。	MX: 4.1+ Android API: 1+
3	Broadcast	「broadcastIntent」を使用してインテントを送信し、1 つまたは複数のアプリケーション内で登録されたブロードキャストレシーバ (リスナ) を呼び出します。	MX: 4.1+ Android API: 1+
4	EnrollDeviceOwner	プロビジョニングおよびデバイス管理のために (パッケージおよびクラスパラメータを使用して指定される) デバイスオーナーを登録するインテントを送信します。Android Setup Wizard と GMS ようこそ画面を省略する場合に便利です。GMS 以外のデバイスでも機能します。	MX: 6.5+ Android API: 24+

アクション名

インテントの受信者が実行するアクションの名前を入力するために使用されます。可能であれば、対象の受信者がサポートすることがわかっているものから指定されたアクション名を選択する必要があります。多くの Android アクション名は事前に定義されていますが、新しいアクション名を追加して、可能なアクション名のセットを実質的に無制限にすることができます。任意の受信者は、アクション名の小さなサブセットのみを受け入れる可能性があります。

注: 使用可能なアクション名のセットは拡張可能であり、インテントでは、指定可能なアクション名に特定の制限は課されません。ただし、Android では、適切な受信者がいないインテントは拒否されます。また、特定の受信者は、特定のアクション名を持つインテントを送信する前に、アプリケーションが保持する権限を要求する場合があります。Android システムまたは特定の受信者によって拒否されたインテントを送信しようとすると、結果の XML にエラーが返されます。

パラメータ値入力ルール:

1 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] ではない場合

パラメータ名: ActionName
要件:

MX: 4.1+

Android API: 1+

タイプ

インテントの送信先アプリケーションのパッケージタイプを入力するために使用されます。このパラメータを使用すると、インテントが [明示的] として分類され、指定されたパッケージタイプのアプリケーションがインストールされていない場合は失敗します。

パラメータ値入力ルール:

ターゲットアプリのパッケージタイプを含む 0 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] ではない場合

パラメータ名: タイプ
要件:

MX: 4.1+

Android API: 1+

カテゴリ

インテントの送信先アプリケーションの Android カテゴリを入力するために使用されます。カテゴリとアクション名を組み合わせて "チャネル" を形成し、同じ組み合わせを使用するインテントをアプリがリッスンすることができるようにします。これは、別の値のペアを使用して、他のインテントの "chatter" を除外する効果があります。アプリのインテントカテゴリは、その AndroidManifest.xml ファイルで定義されます。

パラメータ値入力ルール:

ターゲットアプリのカテゴリを含む文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] ではない場合

パラメータ名: カテゴリ
要件:

MX: 8.0+

Android API: 23+

クラス

指定されたパッケージ名で識別されるアプリ内で、インテントの送信先となるクラス名を入力するために使用されます。このパラメータを入力すると、[明示的] として分類され、指定したアプリ内に該当するクラスが存在しない場合は失敗します。アプリ内でクラスを入力するには、常にパッケージ名とクラス名のパラメータを一緒に使用する必要があります。

パラメータ値入力ルール:

ターゲットアプリのクラス名を含む 1 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] ではない場合

パラメータ名: クラス
要件:

MX: 4.1+

Android API: 1+

Package

インテントの送信先アプリケーションのパッケージ名を入力するために使用されます。このパラメータを使用すると、インテントが [明示的] として分類され、指定されたパッケージ名のアプリがインストールされていない場合は失敗します。アプリ内でクラスを入力するには、常にパッケージ名とクラス名のパラメータを一緒に使用する必要があります。

パラメータ値入力ルール:

ターゲットアプリのパッケージ名を含む 1 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではない場合

パラメータ名: Package
要件:

MX: 4.1+

Android API: 1+

URI

インテントのプライマリデータを識別するためにユニフォームリソースアイデンティファイア (URI) を入力するために使用されます。インテントによって要求された操作によって処理されるプライマリデータ (通常はリモートサーバー上のリソース) がない限り、URI パラメータは必要ありません。ほとんどの場合、MIME タイプも指定して、URI で参照されるデータのタイプを定義する必要があります。

パラメータ値入力ルール:

URI を含む 0 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [StartActivity] または [StartService] の場合

パラメータ名: Uri
要件:

MX: 4.1+

Android API: 1+

ファイル

インテントのプライマリデータを特定するパスとファイル名を入力するために使用されます。インテントで要求された操作で処理するプライマリデータがない限り、ファイルパラメータは必要ありません。場合によっては、ファイル内のデータのタイプを定義するために MIME タイプも指定する必要があります。

パラメータ値入力ルール:

パスおよびファイル名を含む 1 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [StartActivity] または [StartService] の場合

パラメータ名: ファイル
要件:

MX: 4.1+

Android API: 1+

JSON データセレクタ

JSON ファイルまたは文字列を使用してデバイスオーナー (DO) 登録を構成する場合に JSON データの指定方法を入力するために使用されます。

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] の場合

パラメータ名: DOJsonData

オプション	名前	説明	要件
1	何もしない	この値 (またはこのパラメータが XML に存在しないこと) では何も変更されません。以前に選択された設定がすべて保持されます。	OSX: 6.5+ MX: 8.3+ Android API: 23+
2	Json ファイル	JSON ベースのデバイスオーナー構成に JSON ファイルを使用するように指定します。	OSX: 6.5+ MX: 8.3+ Android API: 23+
3	Json 文字列	JSON ベースのデバイスオーナー構成に使用する文字列を指定します。	OSX: 6.5+ MX: 8.3+ Android API: 23+

オプション

名前

説明

注記

ステータス

要件

何もしない

この値 (またはこのパラメータが XML に存在しないこと) では何も変更されません。以前に選択された設定がすべて保持されます。

OSX: 6.5+

MX: 8.3+

Android API: 23+

Json ファイル

JSON ベースのデバイスオーナー構成に JSON ファイルを使用するように指定します。

OSX: 6.5+

MX: 8.3+

Android API: 23+

Json 文字列

JSON ベースのデバイスオーナー構成に使用する文字列を指定します。

OSX: 6.5+

MX: 8.3+

Android API: 23+

デバイスオーナー JSON ファイル

デバイスオーナー (DO) 登録時に使用される構成情報を含む管理ホスト PC 上の JSON ファイルの名前を入力するために使用されます。

パラメータ値入力ルール:

JSON ファイルの名前を含む 1 文字以上の文字列
ファイルは、管理者ホスト PC 上に存在する必要があります

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] で、DO JsonData が [JsonFile] の場合

パラメータ名: DOJsonFileData
要件:

OSX: 6.5+

MX: 8.0+

Android API: 23+

デバイスオーナー JSON 文字列

デバイスオーナーの登録を構成するために必要な文字列として JSON データを入力するために使用されます。

パラメータ値入力ルール:

1 ～ 500 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] で、DO JsonData が [JsonString] の場合

パラメータ名: DOJsonStringData
要件:

OSX: 6.5+

MX: 8.3+

Android API: 23+

追加タイプ

追加のデータ項目としてインテントに付加するデータのデータ型を入力するために使用されます。インテントを使用すると、以下に記載されている設定されたプロンプト、パラメータ名、およびデータ型を使用して、最大 5 つの追加データ項目を添付して送信できます。複数の追加タイプを ExtraType、Extra1Type、Extra2Type、Extra3Type、Extra4Type として入力します。

パラメータ値入力ルール:

下の表で、各タイプの特定の入力ルールを参照してください

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] ではなく、追加タイプが [なし] ではない場合

パラメータ名: ExtraType

オプション	名前	説明	要件
なし	なし	この値 (または XML からのこのパラメータがない場合) では、インテントに添付される、対応する追加データ項目は変更されず、以前に選択した設定が保持されます。	MX: 4.1+ Android API: 1+
int	標準整数	対応する追加のデータ項目を、標準整数のデータ型を使用してインテントに添付します。したがって、指定される値は、-2^31 ～ 2^31 -1 の有効な標準整数値を表す文字列である必要があります。	MX: 4.1+ Android API: 1+
char	文字	対応する追加のデータ項目を、文字のデータ型を使用してインテントに添付します。したがって、指定される値は、1 文字を含む文字列である必要があります。	MX: 4.1+ Android API: 1+
charsequence	文字シーケンス	対応する追加のデータ項目を、文字シーケンスのデータ型を使用してインテントに添付します。したがって、指定される値は、一連の文字を含む文字列である必要があります。このデータ型は、文字列データ型と同等の値を提供するために使用できます。受信者が文字列ではなく文字シーケンスを明示的に要求する場合に使用する必要があります。	MX: 4.1+ Android API: 1+
float	浮動小数点数	対応する追加のデータ項目を単精度浮動小数点のデータ型でインテントに添付します。したがって、指定される値は、有効な単精度 32 ビット IEEE 754 浮動小数点数を表す文字列である必要があります。	MX: 4.1+ Android API: 1+
long	長整数	対応する追加のデータ項目を、長整数のデータ型を使用してインテントに添付します。したがって、指定される値は、-2^63 ～ 2^63-1 の範囲の有効な長整数値を表す文字列である必要があります。	MX: 4.1+ Android API: 1+
boolean	ブール	対応する追加のデータ項目を、ブールのデータ型を使用してインテントに添付します。したがって、指定する値は 1 (true) または 0 (false) の整数でなければなりません。	MX: 4.1+ Android API: 1+
char	文字	対応する追加のデータ項目を、文字のデータ型を使用してインテントに添付します。したがって、指定される値は、1 文字を含む文字列である必要があります。	MX: 4.1+ Android API: 1+
short	短	対応する追加のデータ項目を、短整数のデータ型を使用してインテントに添付します。したがって、指定される値は、-2^15 ～ 2^15-1 までの有効な短整数値を表す文字列である必要があります。	MX: 4.1+ Android API: 1+
double	倍精度浮動小数点数	対応する追加のデータ項目を、倍精度浮動小数点のデータ型を使用するインテントに添付します。したがって、指定される値は、有効な倍精度 64 ビット IEEE 754 浮動小数点数を表す文字列である必要があります。	MX: +
string	文字列	対応する追加のデータ項目を、文字シーケンスのデータ型を使用してインテントに添付します。したがって、指定される値は、一連の文字を含む文字列である必要があります。このデータ型は、文字シーケンスデータ型と同等の値を提供するために使用できます。受信者が文字シーケンスではなく文字列を明示的に要求する場合に使用する必要があります。	MX: 4.1+ Android API: 1+
byte	シングルバイト整数	対応する追加のデータ項目を、シングルバイト整数のデータ型を使用してインテントに添付します。したがって、指定される値は、-2^7 ～ 2^7-1 の有効な 1 バイトの整数値を表す文字列である必要があります。	MX: 4.1+ Android API: 1+

追加名

[なし] 以外のデータ型が指定された追加のデータ項目に添付する追加のデータ項目名を入力するために使用されます。複数の追加名を ExtraName、Extra1Name、Extra2Name、Extra3Name、Extra4Name として入力します。

注: インテントフレームワークでは、追加のデータ項目に指定できる名前に特定の制限はありません。ただし、Zebra では、目的の結果を得るために、インテント受信者が予期するとおりに正確な追加名であることを確認することを推奨します。

パラメータ値入力ルール:

1 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] ではなく、追加タイプが [なし] ではない場合

パラメータ名: ExtraName
要件:

MX: 4.1+

Android API: 1+

追加値

[なし] 以外のデータ型が指定された対応する名前のインテントに添付する追加のデータ項目の値を入力するために使用されます。複数の追加値を、ExtraValue、Extra1Value、Extra2Value、Extra3Value、Extra4Value として入力します。

パラメータ値入力ルール:

1 ～ 255 文字の文字列

次の場合に表示: モードが [キャンセル] または [センサキャンセル] ではなく、アクションが [デバイスオーナーの登録] ではなく、追加タイプが [なし] ではない場合

パラメータ名: ExtraValue
要件:

MX: 4.1+

Android API: 1+

MIME タイプ

目的のプライマリデータのコンテンツ MIME タイプ、または要求された操作の実行に使用されるデータオブジェクトのタイプを入力するために使用されます。MIME タイプは、受信側アプリケーションがデータを処理するのを支援するために、ファイルまたはネットワークリソースに対して一般的に指定されます。実行する操作の実際のデータは、URI またはファイルパラメータを使用して指定する必要があります。

パラメータ値入力ルール:

MIME タイプを含む 0 ～ 255 文字の文字列

パラメータ名: タイプ
要件:

MX: 4.1+

Android API: 1+

モード

プロファイルの実行直後にインテントを送信するか、割り当てられたキーまたはセンサが押されるかトリガされるまで遅延するか、キャンセルするかを制御するために使用します。

パラメータ名: モード

オプション	名前	説明	要件
1	即時	インテントが含まれているプロファイルの実行時に、インテントをただちに送信します。	MX: 10.2+
2	スケジュール	割り当てられたキーが押されるまで、インテントの送信を遅延します。	MX: 10.2+
3	キャンセル	インテントをキャンセルして、割り当てられた打鍵の監視を停止します。	MX: 10.2+
4	sensorSend	選択したセンサがトリガされるたびに、インテントの送信をスケジュールします。	MX: 10.5+
5	sensorCancel	選択したセンサトリガのインテントの送信をキャンセルします。	MX: 10.5+

センサ識別子

インテントをトリガするデバイス、または以前に作成したインテントをキャンセルするデバイス上のセンサのタイプを選択するために使用します。

注: TC21 および TC26 デバイスでのみサポートされます。

次の場合に表示: モードが [センサ送信] または [センサキャンセル] の場合

パラメータ名: SensorIdentifier

オプション	名前	説明	注記	ステータス	要件
1	自由落下検出	デバイスの自由落下が検出されたときにインテントを送信します。			MX: 10.5+

センサパラメータ

センサステータスを決定するために送信する追加名を入力するために使用します。自由落下検出センサがインテントを送信すると、センサパラメータ値に追加が含まれ、ステータスを示します (例: true = 落下検出)。

パラメータ値入力ルール:

1 ～ 255 文字の文字列

次の場合に表示: モードが [センサ送信] で、アクションが [デバイスオーナーの登録] ではなく、センサ ID が [自由落下検出] の場合

パラメータ名: SensorParameter
要件:

MX: 4.1+

Android API: 1+

アラートボタンの動作

[アラート] ボタンを押したときにインテントによって呼び出されるアクションを入力するために使用されます。

次の場合に表示: モードが [スケジュール] または [センサ送信] の場合

パラメータ名: Action3

オプション	名前	説明	要件
1	StartActivity	startActivity を使用してインテントを送信し、アプリケーション内でアクティビティを呼び出します。	MX: 10.2+
2	StartService	startService を使用してインテントを送信し、アプリケーション内でバックグラウンドサービスの操作を開始します。	MX: 10.2+
3	Broadcast	「broadcastIntent」を使用してインテントを送信し、1 つまたは複数のアプリケーション内で登録されたブロードキャストレシーバ (リスナ) を呼び出します。	MX: 10.2+

デバイスを稼働状態に維持する (チェックボックス)

デバイスがサスペンドモードに入ることを許可するかどうかを制御するために使用されます。サスペンドモードでは、消費電力が削減され、バッテリ寿命が長くなります。デバイスを稼働状態に維持すると、通知が受信できない、または打鍵が認識されないのを防止できます。

次の場合に表示: モードが [スケジュール] の場合

パラメータ名: KeepDeviceAwake

オプション	名前	説明	注記	ステータス	要件
0	(オフ)	デバイスがサスペンドモードに入ることを許可します。			MX: 10.2+
1	(オン)	デバイスがサスペンドモードにならないようにします。			MX: 10.2+

例

アプリケーションのメインアクティビティを起動


<wap-provisioningdoc>
    <characteristic type="Intent" version="4.3" >
        <parm name="Action" value="StartActivity"/>
        <parm name="ActionName" value="android.intent.action.MAIN"/>
        <parm name="Package" value="com.sample.myapp"/>
        <parm name="Class" value="com.sample.myapp.MainActivity"/>
    </characteristic>
</wap-provisioningdoc>

デバイスオーナーを登録します


<wap-provisioningdoc>
    <characteristic type="Intent" version="7.0" >
        <parm name="Action" value="EnrollDeviceOwner"/>
        <parm name="Package" value="com.symbol.osx.testdpc"/>
        <parm name="Class" value="com.symbol.osx.testdpc.AdminClass"/>
    </characteristic>
</wap-provisioningdoc>

Intent Manager

概要

インテント タイプ

明示的なインテント

暗黙的なインテント

主な機能

アクション

アクション名

タイプ

カテゴリ

クラス

Package

URI

ファイル

JSON データ セレクタ

デバイス オーナー JSON ファイル

デバイス オーナー JSON 文字列

追加タイプ

追加名

追加値

MIME タイプ

モード

センサ識別子

センサ パラメータ

アラート ボタンの動作

デバイスを稼働状態に維持する (チェックボックス)

例

アプリケーションのメイン アクティビティを起動

デバイス オーナーを登録します

インテントタイプ

JSON データセレクタ

デバイスオーナー JSON ファイル

デバイスオーナー JSON 文字列

センサパラメータ

アラートボタンの動作

アプリケーションのメインアクティビティを起動

デバイスオーナーを登録します