接続コンポーネント

目次

• アクティビティ起動
• Bluetoothクライアント
• Bluetoothサーバー
• Web

アクティビティ起動

StartActivityメソッドを使ってアクティビティを起動できるコンポーネント。

開始できる活動は次のとおりです。

• Androidアプリ用に別のApp Inventorを起動しています。 これを行うには、まずソースコードをダウンロードし、ファイルエクスプローラまたは解凍ユーティリティを使用して「youngandroidproject / project.properties」という名前のファイルを探して、他のアプリケーションのクラスを見つけます。 ファイルの最初の行は “main ="で始まり、その後にクラス名が続きます。 たとえば、 main=com.gmail.Bitdiddle.Ben.HelloPurr.Screen1です。 （最初のコンポーネントは、Ben.Bitdiddle @ gmail.comによって作成されたことを示しています。） ActivityStarterこのアプリケーションを起動させるには、次のプロパティを設定します。
  • ActivityPackageをクラス名にして、最後のコンポーネントを削除します（たとえば、 com.gmail.Bitdiddle.Ben.HelloPurr ）。
  • ActivityClassからクラス全体の名前（たとえば、 com.gmail.Bitdiddle.Ben.HelloPurr.Screen1 ）
• 以下のプロパティを設定してカメラアプリケーションを起動します。
  • Action: android.intent.action.MAIN
  • ActivityPackage: com.android.camera
  • ActivityClass: com.android.camera.Camera
• Web検索を実行しています。 検索したい用語が「吸血鬼」（自分の選択に置き換えても構わない）であると仮定し、プロパティを次のように設定します。
  • アクション：android.intent.action.WEB_SEARCH
  • ExtraKey：クエリ
  • ExtraValue：ヴァンパイア
  • ActivityPackage：com.google.android.providers.enhancedgooglesearch
  • ActivityClass：com.google.android.providers.enhancedgooglesearch.Launcher
• 指定されたWebページにブラウザを開く あなたが行きたいページが “www.facebook.com"（あなた自身の選択を代用しても構わない）であると仮定して、プロパティを次のように設定します。
  • アクション：android.intent.action.VIEW
  • DataUri：http://www.facebook.com

プロパティ

ActionActivityClassActivityPackageDataTypeDataUriExtrasアクティビティの「追加」フィールドでキー/値ペアとして使用されているペアのリストを受け入れますExtraKey (Obsolete)ExtraValue (Obsolete)ResultResultNameResultTypeResultUri

イベント

AfterActivity(text result)このActivityStarterが戻った後に発生するイベント。ActivityCanceled()アクティビティがキャンセルされたためにこのActivityStarterが戻った場合に発生するイベント。

方法

text ResolveActivity()このActivityStarterに対応するアクティビティの名前、または対応するアクティビティが見つからない場合は空の文字列を返します。StartActivity()このActivityStarterに対応するアクティビティを起動します。

Bluetoothクライアント

Bluetoothクライアントコンポーネント

プロパティ

AddressesAndNamesペアリングされたBluetoothデバイスのアドレスと名前AvailableデバイスでBluetoothが使用可能かどうかCharacterEncodingDelimiterByteEnabledBluetoothが有効かどうかHighByteFirstIsConnectedSecureBluetooth v2.1以降を搭載したデバイスでサポートされているSSP（Simple Secure Pairing）を呼び出すかどうか。 内蔵Bluetoothデバイスを使用する場合は、このプロパティをFalseに設定する必要があります。 Android 2.0-2.2の場合、このプロパティ設定は無視されます。

イベント

無し

方法

number BytesAvailableToReceive()ブロックせずに受信できるバイト数の推定値を返すboolean Connect(text address)指定されたアドレスとシリアルポートプロファイル（SPP）でBluetoothデバイスに接続します。 接続が成功した場合はtrueを返します。boolean ConnectWithUUID(text address, text uuid)指定されたアドレスとUUIDでBluetoothデバイスに接続します。 接続が成功した場合はtrueを返します。Disconnect()接続されているBluetoothデバイスから切断します。boolean IsDevicePaired(text address)指定したアドレスのBluetooth機器がペアリングされているか確認します。number ReceiveSigned1ByteNumber()接続しているBluetooth機器から1バイトの符号付き数字を受信します。number ReceiveSigned2ByteNumber()接続されているBluetoothデバイスから2バイトの符号付き数字を受信します。number ReceiveSigned4ByteNumber()接続されているBluetoothデバイスから4バイトの符号付き数字を受信します。list ReceiveSignedBytes(number numberOfBytes)接続されたBluetoothデバイスから複数の符号付きバイト値を受け取ります。 numberOfBytesが0より小さい場合は、区切りバイト値が受信されるまで読み取ります。text ReceiveText(number numberOfBytes)接続されているBluetoothデバイスからテキストを受信します。 numberOfBytesが0より小さい場合は、区切りバイト値が受信されるまで読み取ります。number ReceiveUnsigned1ByteNumber()接続されているBluetoothデバイスから符号なし1バイト番号を受信します。number ReceiveUnsigned2ByteNumber()接続されているBluetoothデバイスから符号なし2バイト番号を受信します。number ReceiveUnsigned4ByteNumber()接続されたBluetoothデバイスから符号なし4バイト番号を受け取ります。list ReceiveUnsignedBytes(number numberOfBytes)接続されているBluetoothデバイスから複数の符号なしバイト値を受信します。 numberOfBytesが0より小さい場合は、区切りバイト値が受信されるまで読み取ります。Send1ByteNumber(text number)接続しているBluetooth機器に1バイトの数字を送信してください。Send2ByteNumber(text number)接続しているBluetooth機器に2バイトの数字を送信してください。Send4ByteNumber(text number)接続しているBluetooth機器に4バイトの数字を送信してください。SendBytes(list list)接続されているBluetoothデバイスにバイト値のリストを送信します。SendText(text text)接続されているBluetoothデバイスにテキストを送信します。

Bluetoothサーバー

Bluetoothサーバーコンポーネント

プロパティ

Available: booleanBluetoothがAndroidデバイスで利用可能かどうかを伝えます。CharacterEncoding: textテキストを送受信するときに使用する文字エンコーディング。DelimiterByte: numberReceiveText、ReceiveSignedBytes、またはReceiveUnsignedBytesを呼び出すときにnumberOfBytesパラメーターに負の数を渡すときに使用する区切りバイト。Enabled: booleanBluetoothが有効になっているかどうかを伝えます。HighByteFirst: boolean2バイトと4バイトの番号を最初に上位（または最上位）バイトで送受信するかどうか。 適切な設定については、アプリが通信するデバイスのドキュメントを確認してください。 これはビッグエンディアンとも呼ばれます。IsAccepting: booleanこのBluetoothServerコンポーネントが着信接続を受け入れているかどうかを伝えます。IsConnected: booleanBluetooth接続が行われたかどうかを伝えます。

イベント

ConnectionAccepted()Bluetooth接続が受け入れられたことを示します。

方法

AcceptConnection(text serviceName)シリアルポートプロファイル（SPP）で着信接続を受け入れます。AcceptConnectionWithUUID(text serviceName, text uuid)特定のUUIDを使用して着信接続を受け入れます。number BytesAvailableToReceive()ブロックせずに受信できるバイト数の推定値を返すDisconnect()接続されているBluetoothデバイスから切断します。number ReceiveSigned1ByteNumber()接続しているBluetooth機器から1バイトの符号付き数字を受信します。number ReceiveSigned2ByteNumber()接続されているBluetoothデバイスから2バイトの符号付き数字を受信します。number ReceiveSigned4ByteNumber()接続されているBluetoothデバイスから4バイトの符号付き数字を受信します。list ReceiveSignedBytes(number numberOfBytes)接続されたBluetoothデバイスから複数の符号付きバイト値を受け取ります。 numberOfBytesが0より小さい場合は、区切りバイト値が受信されるまで読み取ります。text ReceiveText(number numberOfBytes)接続されているBluetoothデバイスからテキストを受信します。 numberOfBytesが0より小さい場合は、区切りバイト値が受信されるまで読み取ります。number ReceiveUnsigned1ByteNumber()接続されているBluetoothデバイスから符号なし1バイト番号を受信します。number ReceiveUnsigned2ByteNumber()接続されているBluetoothデバイスから符号なし2バイト番号を受信します。number ReceiveUnsigned4ByteNumber()接続されたBluetoothデバイスから符号なし4バイト番号を受け取ります。list ReceiveUnsignedBytes(number numberOfBytes)接続されているBluetoothデバイスから複数の符号なしバイト値を受信します。 numberOfBytesが0より小さい場合は、区切りバイト値が受信されるまで読み取ります。Send1ByteNumber(text number)接続しているBluetooth機器に1バイトの数字を送信してください。Send2ByteNumber(text number)接続しているBluetooth機器に2バイトの数字を送信してください。Send4ByteNumber(text number)接続しているBluetooth機器に4バイトの数字を送信してください。SendBytes(list list)接続されているBluetoothデバイスにバイト値のリストを送信します。SendText(text text)接続されているBluetoothデバイスにテキストを送信します。StopAccepting()着信接続を受け付けないようにします。

Web

HTTPのGET、POST、PUT、およびDELETE要求に機能を提供する非表示コンポーネント。

プロパティ

AllowCookies応答からのCookieを保存して後続の要求で使用するかどうか。 クッキーはAndroidバージョン2.3以上でのみサポートされています。RequestHeaders2要素のサブリストのリストとしてのリクエストヘッダー。 各サブリストの最初の要素は、要求ヘッダーフィールド名を表します。 各サブリストの2番目の要素は、要求ヘッダーフィールドの値（単一の値または複数の値を含むリスト）を表します。ResponseFileName応答を保存するファイルの名前。 SaveResponseがtrueでResponseFileNameが空の場合、新しいファイル名が生成されます。SaveResponse応答をファイルに保存するかどうか。UrlWebリクエストのURL。

イベント

GotFile(text url, number responseCode, text responseType, text fileName)要求が終了したことを示すイベント。GotText(text url, number responseCode, text responseType, text responseContent)要求が終了したことを示すイベント。

方法

text BuildRequestData(list list)名前と値のペアを表す2要素のサブリストのリストを、PostTextに渡すのに適したapplication / x-www-form-urlencodedメディアタイプとしてフォーマットされた文字列に変換します。ClearCookies()このWebコンポーネントのすべてのクッキーを消去します。Delete()Urlプロパティを使用してHTTP DELETE要求を実行し、その応答を取得します。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 ResponseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。Get()Urlプロパティを使用してHTTP GETリクエストを実行し、そのレスポンスを取得します。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 ResponseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。text HtmlTextDecode(text htmlText)与えられたHTMLテキスト値をデコードします。 ＆amp;、＆lt;、＆gt;、＆apos;、＆quot;などのHTML文字エンティティ。 ＆、<、>、 '、および “に変更されます。＆＃xhhhh、＆＃nnnnなどのエンティティは、適切な文字に変更されます。any JsonTextDecode(text jsonText)指定されたJSONエンコード値をデコードして、対応するAppInventor値を生成します。 JSONリスト[x、y、z]はリスト（xyz）にデコードします。名前Aと値Bを持つJSONオブジェクト（中括弧で囲まれたA：Bと表記）はリスト（（AB））にデコードします。これは、2要素のリスト（AB）を含むリストです。PostFile(text path)Urlプロパティと指定されたファイルのデータを使用してHTTP POST要求を実行します。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 ResponseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。PostText(text text)Urlプロパティと指定されたテキストを使用してHTTP POST要求を実行します。 
テキストの文字はUTF-8エンコードを使用してエンコードされています。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 responseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。PostTextWithEncoding(text text, text encoding)Urlプロパティと指定されたテキストを使用してHTTP POST要求を実行します。 
テキストの文字は与えられたエンコーディングを使ってエンコードされます。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 ResponseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。PutFile(text path)Urlプロパティと指定したファイルのデータを使用してHTTP PUT要求を実行します。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 ResponseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。PutText(text text)Urlプロパティと指定されたテキストを使用してHTTP PUTリクエストを実行します。 
テキストの文字はUTF-8エンコードを使用してエンコードされています。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 responseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。PutTextWithEncoding(text text, text encoding)Urlプロパティと指定されたテキストを使用してHTTP PUTリクエストを実行します。 
テキストの文字は与えられたエンコーディングを使ってエンコードされます。 
SaveResponseプロパティがtrueの場合、応答はファイルに保存され、GotFileイベントが発生します。 ResponseFileNameプロパティを使用してファイルの名前を指定できます。 
SaveResponseプロパティがfalseの場合、GotTextイベントが発生します。text UriEncode(text text)指定されたテキスト値をURLで使用できるようにエンコードします。text UriDecode(text text)値がURLエンコードされないように、エンコードされたテキスト値をデコードします。any XMLTextDecode(text XmlText)指定されたXML文字列をデコードしてリスト構造を作成します。 詳細については、App Inventorのドキュメントの「その他のトピック、メモ、および詳細」を参照してください。