Interop 外部オブジェクト (
KB エクスプローラーの
Smart Devices API にあります) は、手続き型プログラミングを使用してデバイスを操作するために使用されます。
Interop 外部オブジェクトは、SD モジュール内の
KB エクスプローラーの中にあり、このモジュールは GeneXus モジュールの中にあります。つまり、
Smart Devices API の一部です。
アプリケーションの現在の状態を示します。その値は、以下に一覧と説明を示す ApplicationState ドメインに属しています:
キー |
値 |
説明 |
0 |
Active |
アプリケーションがフォアグラウンドにあるか、イベントを受信済みです。 |
1 |
Inactive |
アプリケーションはフォアグラウンドにありますが、イベントを受信していません。中断が発生したとき (電話の着信など) や、バックグラウンド状態からの切り替え中に発生することがあります。 |
2 |
Background |
アプリケーションがフォアグラウンドでない状態です。 |
アプリケーションの状態を知ることは、イベント管理のシナリオ (プッシュ通知やイベントの場所など) や、実装の状態に応じて異なるアクションを実行するのに有用です。
注: Android デバイスでは、Inactive 状態の動作は存在しません。そのため、そのようなデバイスでは、プロパティの値は Active と Background のいずれかのみになります。
Android ジェネレーターおよび Apple ジェネレーターで、デバイスの画面の明るさを取得または設定します。
デバイスに明るさの値を割り当てることができます。値の範囲は 0.0 ~ 1.0 です。
&Brightness = Interop.ScreenBrightness
戻り値 Numeric(6.2)
注
- Android での既定値は -1 です。この値を使用すると、明るさはデバイスの既定値に戻ります。
- 明るさの値は、画面が変更されない限り変更されます。現在の画面を終了すると、デバイスの既定の明るさの値に戻ります。
この例は、デバイスの明るさを取得する方法を示しており、値が 0.5 よりも小さい場合は、その値を変更できます。
Event 'SampleBrightness'
Composite
&BrightnessVar = Interop.ScreenBrightness
If &BrightnessVar < 0.5
Interop.ScreenBrightness = 0.5
EndIf
EndComposite
Endevent
チャネルを指定せずに連絡先 (電話番号、メールアドレス、Facebook アカウントなど) にメッセージを送ります。
「Interop 外部オブジェクトから SendMessage メソッドを使用する方法」を参照してください。
URI (
http、
file または
data スキームなど) にある動画を再生します。
「Interop 外部オブジェクトから PlayVideo メソッドを使用する方法」を参照してください。
URI (
http、
file、または
data スキームなど) にある音声を再生します。
「Interop 外部オブジェクトから PlayAudio メソッドを使用する方法」を参照してください。
定義されたアプリケーションを開き、電話番号を入力して電話をかけます。
「Interop 外部オブジェクトから PlaceCall メソッドを使用する方法」を参照してください。
戻り値 |
なし |
パラメーター |
Phone: 電話番号
|
ネイティブなメールクライアントを使用してシンプルなメールを送信します。
「Interop 外部オブジェクトから SendEmail メソッドを使用する方法」を参照してください。
ネイティブなメールクライアントを使用して、より複雑なメールを複数の宛先に送信します。
「ネイティブ モバイル アプリケーションで Interop 外部オブジェクトから SendEmailAdvanced メソッドを使用する方法」を参照してください。
宛先の電話番号に SMS (
Small Message System) を送信します。
「Interop 外部オブジェクトから SendSMS メソッドを使用する方法」を参照してください。
メッセージをエンドユーザーに表示します。
「Interop 外部オブジェクトから Msg メソッドを使用する方法」を参照してください。
注: パラメーター「OkButtonText」は任意であり、GeneXus 16 Upgrade 9 以降で使用可能です。
エンドユーザーにメッセージを表示して、確認されたら True を、確認されなかったら False を返します。戻り値が使用されない場合は、イベントの実行がキャンセルされます。
「Interop 外部オブジェクトから Confirm メソッドを使用する方法」を参照してください。
注: パラメーター「OkButtonText」および「CancelButtonText」は任意であり、
GeneXus 16 Upgrade 9 以降で使用可能です。
デバイスの既定の Web ブラウザーで URL を開きます。
スマート デバイス アプリケーションから新しいブラウザーウィンドウで Web ページを開く方法
URL が開ける (True) か開けない (False) かを確認します。
「
Interop.CanOpen メソッド」を確認してください。
スキームに応じた適切なアプリケーションを使用して URI コンテンツを開きます。
たとえば、
http スキームは
ディープリンクや Web コンテンツをブラウザーで開くことができます。
mailto スキームは電子メールクライアントを、
maps スキームはマップアプリケーションを開きます。
URI スキームの定義および「
Interop.Open メソッド」を確認してください。
デバイス上のキャッシュを消去することができます。
Smart Devices Api 内の Interop の ClearCache メソッドを使用する方法
アプリケーションのアイコンに数値のバッジを設定します。
「Apple でバッジ操作を使用する方法」を参照してください。
Menu object with Control Type = Tabs を使用してタブのインデックスにバッジテキストを設定します。
「Apple でバッジ操作を使用する方法」を参照してください。
Menu object with Control Type = Tabs を使用する場合にインデックスを示すコードでタブを選択します。
「Apple でバッジ操作を使用する方法」を参照してください。
ネイティブ モバイル アプリケーションで
Composite コマンドが失敗したときにエラーを表示するために自動的に実行されるのと同じことを実行します。
「ネイティブ モバイル アプリケーションで Interop の ShowError メソッドを使用する方法」を参照してください。
エンドユーザーをデバイスまたはアプリケーションの特定の設定画面にリダイレクトします。
MobileSettings ドメインを使用することで、オプション "General" および "Application" から選択できます。
- "General" を選択すると、エンドユーザーは一般的なデバイス設定オプションに誘導されます。
- 一方、"Application" を選択すると、エンドユーザーはアプリケーション固有の設定オプションに移動します。
戻り値 |
なし |
パラメーター |
Screen:MobileSettings、GeneXus.SD、Option:MobileSettingsOptions、GeneXus.SD |
以下のコードは、アプリケーションの通知設定に移動します。
Event "ManualSettingConfg".
Interop.OpenSettings(MobileSettings.Application, MobileSettingsOptions.notifications)
EndEvent
デバイスまたはアプリケーションの設定画面に対応する特定の URL を開きます。
戻り値 |
なし |
パラメーター |
Url:VarChar |
なし
利用可能なアプリケーションの状態の一覧です。
Active |
アプリケーションがフォアグラウンドにあるか、イベントを受信済みです。 |
Inactive |
アプリケーションはフォアグラウンドにありますが、イベントを受信していません。中断が発生したとき (電話の着信など) や、バックグラウンド状態からの切り替え中に発生することがあります。 |
Background |
アプリケーションがフォアグラウンドでない状態です。 |
MobileSettings |
次の 2 つのオプションを指定します: "General" および "Application"。 |
MobileSettingsOptions |
"Bluetooth"、"Wi-Fi"、"Sound"、"Notifications"、"Location" などのオプションがあり、設定を指定できます。 |
|
注:
Apple の場合、値 "Application" を有効なオプションとしてサポートしているのは、MobileSettings ドメインのみです。MobileSetingsOptions ドメインでサポートされる唯一の値は Notifications です。また、アプリケーションが通知のアクセス許可を要求しなかった場合、アプリケーション固有の通知設定ではなく、一般的な通知設定にリダイレクトされます。
ジェネレーター: Android、
Apple
OpenSettings メソッドと OpenSettingsURL メソッドおよび MobileSettings ドメインと MobileSettingsOptions ドメインは、
GeneXus 18 Upgrade 4 以降で使用できます。