HT API version 10

ExternalServiceクラス

Android

Object

 

 

 

 

 

 

ExternalService

 

 

 

Biz/Browser HT用のインターフェースを持った外部サービスと連携するクラスです。

ButtonやLabel等と同じように、オブジェクトツリーに接続した状態で使います。

 

外部サービス

 

このクラスは、別途Biz/Browser SmartDeviceおよびBiz/Browser HTがこのクラスを用いて連携するための専用のインターフェースを持ったサービス(Android サービス)が必要となります。

専用のインターフェースを持たないサービスや、その他のアプリとは、このクラスを用いて連携することはできません。

Android標準のインテント機能を用いて連携可能な外部アプリを使用する場合はIntentクラス、Android SDKやjar形式のライブラリのクラスを扱う場合はExternalObjectクラスの使用を検討してください。

 

Biz/Browser HT 1.2.6より、Android11以降の端末では、Biz/Browserは特定のパッケージ名のサービスとしか連携できません。

 

通信プロトコルバージョン

 

APIバージョン24で、外部サービスとの通信プロトコルバージョンが定義されました。

ExternalServiceクラスは、外部サービスが対応している通信プロトコルバージョンに応じた機能を利用することができます。

 

通信プロトコルの各バージョンで追加された機能は下記の通りです。

 

通信プロトコルバージョン

対応APIバージョン

追加機能

1

HT(10)

新規作成

2

HT(24)

ByteArrayクラスオブジェクト、Imageクラスオブジェクトの受け渡しが可能になりました。

・外部サービス側に追加されたCRS向けの例外(CRSExternalException)に対応しました。

 Biz/Browser HTはCRSExternalException例外に設定された情報を解釈し、Exception.Codeプロパティ、Exception.Messageプロパティ、Exception.Methodプロパティの内容を設定します。

 

接続中の外部サービスとの間で使用している通信プロトコルバージョンはUsingProtocolVersionプロパティで確認できます。

 

デフォルトプロパティとValueType

 

デフォルトプロパティはありません。ValueTypeの指定は無効です。

 

セキュリティレベル

 

Biz/Browser V、Biz/Browser SmartDeviceおよびBiz/Browser HTでは、ExternalObjectパッケージの利用はセキュリティレベルによって制限されています。ExternalObjectパッケージはセキュリティレベルを0に設定することで利用できます。

セキュリティレベル1以上では、ExternalServiceクラスをインスタンス化しようとしたときに例外が発生します。

 

 

プロパティ | メソッド | イベント

 



「オンラインマニュアル」一覧へ戻る
「Bizの宝箱」TOPへ戻る