ソーシャルコンポーネント

目次

連絡先

クリックすると、選択可能な連絡先のリストが表示されるボタン。 ユーザーが選択した後、選択した連絡先に関する情報に次のプロパティが設定されます。

  • ContactName ：連絡先の名前
  • EmailAddress ：連絡先のメインのメールアドレス
  • EmailAddressList ：連絡先のEメールアドレスのリスト
  • ContactUri ：デバイス上の連絡先のURI
  • PhoneNumber ：連絡先のメインの電話番号（後のAndroid Verisons上）
  • PhoneNumberList ：連絡先の電話番号のリスト（後のAndroidバージョン）
  • Picture ：連絡先の画像を含むファイルの名前ImageSpriteまたはImageSpriteコンポーネントのPictureプロパティ値として使用できます。

他のプロパティはボタンの外観（ TextAlignment 、 BackgroundColorなど）とクリック可能かどうか（ Enabled ）に影響します。

ContactPickerコンポーネントは、一部の電話機では機能しない可能性があります。 たとえば、システム3.0以前のAndroidシステムでは、電話番号を選択できず、電子メールアドレスのリストに含まれる電子メールは1つだけです。

プロパティ

BackgroundColorボタンの背景色を返しますContactNameEmailAddressContactUriデバイス上の連絡先の場所を指定するURI。EnabledFontBold （デザイナーのみ）FontItalic （デザイナーのみ）FontSize （デザイナーのみ）FontTypeface （デザイナーのみ）HeightImageボタンの画像のパスを指定します。 ImageとBackgroundColorの両方がある場合は、Imageだけが表示されます。PictureShape （デザイナーのみ）ボタンの形状（デフォルト、丸み、長方形、楕円形）を指定します。 画像が表示されている場合、形状は表示されません。ShowFeedback背景としての画像としてのボタンに対して視覚的なフィードバックを表示するかどうかを指定します。TextTextAlignment （デザイナーのみ）TextColorVisibleコンポーネントを画面に表示するかどうかを指定します。 コンポーネントが表示されている場合は値はtrue、非表示になっている場合はfalseです。Width

イベント

AfterPicking()ピッカーアクティビティが結果を返し、プロパティが入力された後に発生する単純なイベントです。BeforePicking()コンポーネントがクリックされたとき、ピッカーアクティビティが開始される前に発生する単純なイベント。GotFocus()カーソルがボタンの上に移動したため、クリックできるようになりました。LostFocus()カーソルがボタンから移動したため、クリックできなくなったことを示します。

方法

Open()ユーザーがクリックしたかのように、ピッカーを開きます。ViewContact(uri)URIを指定して連絡先を表示します。

Email

EmailPickerは一種のテキストボックスです。 ユーザーが連絡先の名前または電子メールアドレスの入力を開始すると、電話は入力を完了する選択肢のドロップダウンメニューを表示します。 多数の連絡先がある場合、ドロップダウンが表示されるまでに数秒かかることがあり、一致の計算中に中間結果が表示されることがあります。

テキストボックスの最初の内容とユーザー入力後の内容はTextプロパティにあります。 Textプロパティが最初は空の場合、 Hintプロパティの内容はテキストボックスにユーザーへのヒントとしてかすかに表示されます。

他のプロパティはテキストボックスの外観（ TextAlignment 、 BackgroundColorなど）とそれが使用可能かどうか（ Enabled ）に影響します。

このようなテキストボックスは通常Buttonコンポーネントで使用され、ユーザーはテキスト入力が完了したときにボタンをクリックします。

方法

RequestFocus()EmailPickerをアクティブにします。

プロパティ

BackgroundColor入力ボックスの背景色。 デザイナまたはブロックエディタで名前を使って色を選択できます。 デフォルトの背景色は ‘default’（3次元陰影）です。Enabledユーザーがこの入力ボックスにテキストを入力できるかどうか デフォルトでは、これは真です。FontBold （デザイナーのみ）テキストのフォントを太字にするかどうか。 デフォルトでは、そうではありません。FontItalic （デザイナーのみ）テキストを斜体で表示するかどうか。 デフォルトでは、そうではありません。FontSizeテキストのフォントサイズ。 デフォルトでは14.0ポイントです。FontTypeface （デザイナーのみ）テキストのフォント 値はDesignerで変更できます。HeightHintユーザーが何を入力すべきかについてのヒントを提供するために入力ボックスにかすかに表示されるべきテキスト。 これは、 Textプロパティが空の場合にのみ表示されます。Text入力ボックス内のテキスト。これは、DesignerまたはBlocks Editorでプログラマが設定することも、ユーザーが入力することもできます（ Enabledプロパティがfalseの場合を除く）。TextAlignment （デザイナーのみ）テキストを左揃え、中央揃え、または右揃えにするかどうか。 デフォルトでは、テキストは左揃えになっています。TextColorテキストの色 デザイナまたはブロックエディタで名前を使って色を選択できます。 デフォルトのテキスト色は黒です。Visibleコンポーネントを画面に表示するかどうかを指定します。 コンポーネントが表示されている場合は値はtrue、非表示になっている場合はfalseです。Width

イベント

GotFocus()ユーザーがタッチするなどして、このコンポーネントが入力用に選択されたときに発生するイベント。LostFocus()ユーザーが別のテキストボックスをタッチした場合など、このコンポーネントが入力用に選択されなくなったときに発生するイベント。

方法

無し

電話をかける

PhoneNumberプロパティで指定された番号に電話をかける非表示コンポーネントです。これは、デザイナまたはブロックエディタで設定できます。 このコンポーネントにはMakePhoneCallメソッドがあり、プログラムで電話をかけることができます。

多くの場合、このコンポーネントはContactPickerコンポーネントと共に使用されます。これにより、ユーザーは電話に保存されている連絡先から連絡先を選択し、 PhoneNumberプロパティを連絡先の電話番号に設定できます。

電話番号を直接指定するには（例：650-555-1212）、 PhoneNumberプロパティを指定された桁数のTextに設定します（例： “6505551212”）。 ダッシュ、ドット、および括弧を含めることができます（たとえば、 “（650）-555-1212″）が無視されます。 スペースを含めることはできません。

プロパティ

PhoneNumber

イベント

IncomingCallAnswered(text phoneNumber)電話の着信に応答したことを示すイベント。 phoneNumberは着信電話番号です。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。PhoneCallEnded(number status, text phoneNumber)通話が終了したことを示すイベント。 ステータスが1の場合、着信コールは不在または拒否されます。 statusが2の場合、電話が切れる前に着信に応答します。ステータスが3の場合、発信通話は切断されます。 phoneNumberは、終了コールの電話番号です。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。PhoneCallStarted(number status, text phoneNumber)電話が開始されたことを示すイベント。 状況が1の場合、着信呼び出しは鳴っています。 ステータスが2の場合、発信通話がダイヤルされます。 phoneNumberは、着信または発信の電話番号です。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。

方法

MakePhoneCall()電話をかけるために電話のデフォルトのダイヤラアプリを起動します。MakePhoneCallDirect()PhoneNumberプロパティの番号を使用して電話をかけます。 このブロックは、電話機のデフォルトの電話アプリケーションとして機能する可能性のあるアプリケーションを開発したい上級開発者を対象としています。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。

電話番号選択

クリックすると、連絡先の電話番号のリストが表示されるボタン。 ユーザーが選択した後、選択した連絡先に関する情報に次のプロパティが設定されます。

  • ContactName ：連絡先の名前
  • PhoneNumber ：連絡先の電話番号
  • EmailAddress ：連絡先のメールアドレス
  • Picture ：連絡先の画像を含むファイルの名前ImageSpriteまたはImageSpriteコンポーネントのPictureプロパティ値として使用できます。

他のプロパティはボタンの外観（ TextAlignment 、 BackgroundColorなど）とクリック可能かどうか（ Enabled ）に影響します。

PhoneNumberPickerコンポーネントは、すべてのAndroidデバイスで機能するわけではありません。 たとえば、システム3.0より前のAndroidシステムでは、返される電話番号とEメールアドレスのリストは空になります。

プロパティ

BackgroundColorボタンの背景色を返しますContactNameEmailAddressEnabledFontBold （デザイナーのみ）FontItalic （デザイナーのみ）FontSize （デザイナーのみ）FontTypeface （デザイナーのみ）HeightImageボタンの画像のパスを指定します。 ImageとBackgroundColorの両方がある場合は、Imageだけが表示されます。PhoneNumberPictureShape （デザイナーのみ）ボタンの形状（デフォルト、丸み、長方形、楕円形）を指定します。 画像が表示されている場合、形状は表示されません。ShowFeedback背景としての画像としてのボタンに対して視覚的なフィードバックを表示するかどうかを指定します。TextTextAlignment （デザイナーのみ）TextColorVisibleコンポーネントを画面に表示するかどうかを指定します。 コンポーネントが表示されている場合は値はtrue、非表示になっている場合はfalseです。Width

イベント

AfterPicking()ピッカーアクティビティが結果を返し、プロパティが入力された後に発生する単純なイベントです。BeforePicking()コンポーネントがクリックされたとき、ピッカーアクティビティが開始される前に発生する単純なイベント。GotFocus()カーソルがボタンの上に移動したため、クリックできるようになりました。LostFocus()カーソルがボタンから移動したため、クリックできなくなったことを示します。

方法

Open()ユーザーがクリックしたかのように、ピッカーを開きます。

Sharing

共有は、アプリとデバイスにインストールされている他のアプリとの間でファイルやメッセージを共有できるようにする非表示コンポーネントです。 コンポーネントは、提供された情報を処理できるインストール済みアプリのリストを表示し、ユーザーがコンテンツを共有するものを選択できるようにします。たとえば、メールアプリ、ソーシャルネットワークアプリ、テキストメッセージアプリなどです。 
ファイルパスは、CameraやImagePickerなどの他のコンポーネントから直接取得できますが、ストレージから読み取るように直接指定することもできます。 デバイスごとにストレージの扱いが異なることに注意してください。たとえば、 Appinventor/assetsフォルダにAppinventor/assetsというファイルがある場合に試すことがいくつかあります。

  • "file:///sdcard/Appinventor/assets/arrow.gif"
  • "/storage/Appinventor/assets/arrow.gif"

プロパティ

無し

イベント

無し

方法

ShareFile(text file)利用可能なアプリのリストを表示し、そのリストからユーザーが選択できるようにすることで、電話機にインストールされている機能のあるアプリケーションを通してファイルを共有します。 選択したアプリはファイルが挿入された状態で開きます。ShareFileWithMessage(text file, text message)利用可能なアプリのリストを表示し、ユーザーがリストからいずれかを選択できるようにすることで、電話機にインストールされている機能のあるアプリケーションを通じてファイルとメッセージの両方を共有します。 選択したアプリがファイルとメッセージを挿入した状態で開きます。ShareMessage(text message)利用可能なアプリのリストを表示し、そのリストからユーザーが選択できるようにすることで、電話機にインストールされている機能のあるアプリケーションを介してメッセージを共有します。 選択したアプリはメッセージが挿入された状態で開きます。

ショートメッセージ

SendMessageメソッドが呼び出されたときに、 Messageプロパティで指定されたテキストメッセージをPhoneNumberプロパティで指定された電話番号に送信するPhoneNumber 。

ReceivingEnabledプロパティが1に設定されている場合、メッセージは受信されません。 ReceivingEnabledが2に設定されている場合、メッセージはアプリケーションの実行中にのみReceivingEnabledされます。 最後に、 ReceivingEnabledが3に設定されている場合、メッセージはアプリケーションが実行されているときと受信されていないときに受信され、キューに入れられてユーザーに通知が表示されます。

メッセージが到着すると、 MessageReceivedイベントが発生し、送信番号とメッセージを提供します。

このコンポーネントを含むアプリは、バックグラウンドにあるとき（つまり画面に表示されていないとき）でも、さらに、アプリが実行されていない場合でも、電話にインストールされている限り、メッセージを受信します。 アプリが前面に表示されていないときに電話がテキストメッセージを受信した場合、電話は通知バーに通知を表示します。 通知を選択するとアプリが起動します。 アプリ開発者としては、おそらく、ユーザーにReceivingEnabledを制御して電話でテキストメッセージを無視させることができます。

GoogleVoiceEnabledプロパティがtrueの場合、メッセージはGoogle Voiceを使用してWifi経由で送信できます。 このオプションを使用するには、ユーザーがGoogle Voiceアカウントを持っており、モバイルVoiceアプリが電話にインストールされている必要があります。 Google Voiceオプションは、Android 2.0（Eclair）以降をサポートしている電話でのみ機能します。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。

電話番号（650- 555-1212など）を指定するには、 PhoneNumberプロパティを指定された桁数のText文字列（例：6505551212）に設定します。 ダッシュ、ドット、および括弧を含めることができます（例：（650）-555-1212）が、無視されます。 スペースを含めることはできません。

アプリが電話番号を指定するもう1つの方法は、 PhoneNumberPickerコンポーネントを含めることです。これを使用すると、ユーザーは電話の連絡先に保存されている電話番号から電話番号を選択できます。

プロパティ

GoogleVoiceEnabledtrueの場合、SendMessageはGoogle Voiceを使用してWifi経由でメッセージを送信しようとします。 これには、Google VoiceアプリをGoogle Voiceアカウントを使用して電話またはタブレットにインストールして設定する必要があります。 GoogleVoiceEnabledがfalseの場合、このコンポーネントとメッセージを送受信するには、デバイスに電話とテキストメッセージのサービスが必要です。 Google Voiceは米国内でのみ利用可能で、一部の電話ネットワークではサポートされていません。MessageSendMessageメソッドが呼び出されたときに送信されるメッセージ。 標準のSMSメッセージの最大長は通常170です。発音区別符号を使用している言語では、それより短くなることがあります。PhoneNumberSendMessageメソッドが呼び出されたときにメッセージが送信される番号。 番号は指定された桁数のテキスト文字列です（例：6505551212）。 ダッシュ、ドット、および括弧を含めることができます（例：（650）-555-1212）が、無視されます。 スペースは含めないでください。ReceivingEnabled1（オフ）に設定した場合、メッセージは受信されません。 2（FOREGROUND）または3（ALWAYS）に設定されている場合、コンポーネントは実行中の場合はメッセージに応答します。 2（FOREGROUND）の場合、アプリが実行されていない間に受信されたメッセージは破棄されます。 3（常に）の場合、アプリが実行されていない間にmessagess receiveが通知を表示します。 通知を選択するとアプリが起動し、MessageReceivedイベントが発生します。 アプリが休止しているときに受信したメッセージはキューに入れられるため、アプリが起動したときにいくつかのMessageReceivedイベントが表示されることがあります。 アプリ開発者として、このプロパティをユーザーに制御させることをお勧めします。そうすれば、アプリがインストールされたときに、ユーザーが自分の携帯電話にテキストメッセージを無視させることができます。

イベント

MessageReceived(text number, text messageText)テキストメッセージが電話で受信されたときに発生するイベント。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。

方法

SendMessage()メッセージと電話番号が事前に入力されている状態で、電話のデフォルトのテキストメッセージングアプリケーションを起動します。SendMessageDirect()テキストメッセージを送る。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。

Twitter

Twitterとのコミュニケーションを可能にする見えないコンポーネント。 ユーザーが自分のTwitterアカウントにログインすると（そして、 IsAuthorizedイベントによって承認が成功したことが確認されると）、さらに多くの操作が可能になります。

  • Twitterでツイートやラベルを検索する（ SearchTwitter ）
  • ツイートを送信する（ Tweet ）
  • 画像付きツイートの送信（ TweetWithImage ）
  • 特定のユーザーにメッセージを送信する（ DirectMessage ）
  • ログインユーザーRequestDirectMessages最新のメッセージを受信する（ RequestDirectMessages ）
  • 特定のユーザーをFollowする（ Follow ）
  • 特定のユーザーをフォローするのをStopFollowing （ StopFollowing ）
  • ログインユーザーに続くユーザーのリストを取得する（ RequestFollowers ）
  • 最新のユーザーのメッセージに続いてログインしたユーザーを取得する（ RequestFriendTimeline ）
  • ログインユーザーの最新の言及を取得する（ RequestMentions ）

http://twitter.com/oauth_clients/newから、アプリに固有のTwitter認証のためのConsumer KeyおよびConsumer Secretを取得する必要があります。

プロパティ

ConsumerKeyOAuthを介してTwitterで認証するときに使用される消費者キー。ConsumerSecretOAuthを介してTwitterで認証するときに使用される消費者秘密DirectMessagesこのプロパティには、ログインユーザーに言及している最新のメッセージのリストが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません。

  1. Authorizeメソッドを呼び出します。
  2. Authorizedイベントを待ちます。
  3. RequestDirectMessagesメソッドを呼び出します。
  4. DirectMessagesReceivedイベントを待ちます。

このプロパティの値は、取得されたダイレクトメッセージのリストに設定されます（そしてその後のRequestDirectMessages呼び出しまでその値を維持します）。Followersこのプロパティには、ログインユーザーのフォロワーのリストが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません。

  1. Authorizeメソッドを呼び出します。
  2. IsAuthorizedイベントを待ちます。
  3. RequestFollowersメソッドを呼び出します。
  4. FollowersReceivedイベントを待ちます。

このプロパティの値は、フォロワーのリストに設定されます（そして、その後のRequestFollowersへの呼び出しまでその値を維持します）。FriendTimelineこのプロパティには、フォローされているユーザーの最新の20件のメッセージが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません。

  1. Authorizeメソッドを呼び出します。
  2. IsAuthorizedイベントを待ちます。
  3. Followメソッドへの1つ以上の呼び出しでフォローするユーザーを指定します。
  4. RequestFriendTimelineメソッドを呼び出します。
  5. FriendTimelineReceivedイベントを待ちます。

このプロパティの値はメッセージのリストに設定されます（そして、その後のRequestFriendTimelineへの呼び出しまでその値を維持します）。Mentionsこのプロパティにはログインユーザのメンションのリストが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません

  1. Authorizeメソッドを呼び出します。
  2. IsAuthorizedイベントを待ちます。
  3. RequestMentionsメソッドを呼び出します。
  4. MentionsReceivedイベントを待ちます。

このプロパティの値は、次にメンションのリストに設定されます（そして、その後のRequestMentions呼び出しまでその値を維持します）。SearchResultsこのプロパティは、最初は空ですが、プログラムの実行後に検索結果のリストに設定されます。

  1. SearchTwitterメソッドを呼び出します。
  2. SearchSuccessfulイベントをSearchSuccessfulます。

プロパティの値はSearchSuccessfulのパラメータと同じになります。 SearchTwitter呼び出す前にAuthorizeメソッドを呼び出す必要はありません。Username許可ユーザーのユーザー名。 許可ユーザーがいない場合は空です。

イベント

DirectMessagesReceived(list messages)このイベントは、 RequestDirectMessagesを通じて要求された最近のメッセージが取得されたときに発生します。 メッセージのリストは、messagesパラメータまたはMessagesプロパティにあります。FollowersReceived(list followers2)このイベントは、 RequestFollowersを通じて要求されたログインユーザーのすべてのフォロワーが取得されたときに発生します。 フォロワーのリストは、followersパラメーターまたはFollowersプロパティで見つけることができます。FriendTimelineReceived(list timeline)このイベントは、 RequestFriendTimelineを通じて要求されたメッセージが取得されたときに発生します。 timelineパラメータとTimelineプロパティにはリストのリストが含まれ、各サブリストにはフォームのステータスの更新が含まれます（ユーザー名メッセージ）。IsAuthorized()承認が成功した場合、プログラムがAuthorize呼び出した後にこのイベントが発生します。 すでに有効なアクセストークンがある場合は、 CheckAuthorizedへの呼び出しの後にも呼び出されます。 このイベントが発生した後、このコンポーネントの他のメソッドを呼び出すことができます。MentionsReceived(list mentions)このイベントは、 RequestMentionsを通じて要求されたログインユーザーの言及が取得されたときに発生します。 メンションのリストは、 MentionsパラメータまたはMentionsプロパティにあります。SearchSuccessful(list searchResults)このイベントは、 SearchSuccessfulを介して要求された検索結果が取得されたときに発生します。 結果のリストはresultsパラメータまたはResultsプロパティにあります。

方法

Authorize()まだ認証されていない場合は、OAuthプロトコルを使用してWebブラウザ経由でTwitterにログインするようにユーザーをリダイレクトします。CheckAuthorized()アクセス権があるかどうかを確認し、アクセス権がある場合はIsAuthorizedイベントハンドラを呼び出します。DeAuthorize()この実行中のアプリインスタンスからTwitter認証を削除しますDirectMessage(text user, text message)これにより、指定されたユーザーに直接（プライベート）メッセージが送信されます。 メッセージが160文字を超えると、メッセージは切り捨てられます。

要件 ： IsAuthorizedイベントが発生した後にのみ呼び出されます。これは、ユーザーがTwitterに正常にログインしたことを示します。Follow(text user)ユーザーのフォローを開始します。RequestDirectMessages()ログインしているユーザーに送信された最新の20のダイレクトメッセージを要求します。 メッセージが取得されると、システムはDirectMessagesReceivedイベントを発生させ、 DirectMessagesプロパティをメッセージのリストに設定します。

要件 ： IsAuthorizedイベントが発生した後にのみ呼び出されます。これは、ユーザーがTwitterに正常にログインしたことを示します。RequestFollowers()あなたをフォローしている人を取得します。RequestFriendTimeline()ユーザーのタイムライン内の最新の20のメッセージを取得します。RequestMentions()ログインユーザーの最新の20の言及を要求します。 言及が取得されると、システムはMentionsReceivedイベントを発生させ、 Mentionsプロパティを言及のリストに設定します。

要件 ： IsAuthorizedイベントが発生した後にのみ呼び出されます。これは、ユーザーがTwitterに正常にログインしたことを示します。SearchTwitter(text query)これはTwitterで与えられたStringクエリを検索します。

要件 ： IsAuthorizedイベントが発生した後にのみ呼び出されます。これは、ユーザーがTwitterに正常にログインしたことを示します。StopFollowing(text user)ユーザーのフォローを中止します。Tweet(text status)これはログインユーザとして指定されたテキストでツイートを送信します。これは160文字を超えると切り取られます。

要件 ： IsAuthorizedイベントが発生した後にのみ呼び出されます。これは、ユーザーがTwitterに正常にログインしたことを示します。TweetWithImage(text status, text imagePath)これは、指定されたテキストとアップロードされる画像へのパスを持つログインユーザとしてツイートを送信します。これは、160文字を超えると切り取られます。 画像が見つからないか無効な場合、更新は送信されません。

要件 ： IsAuthorizedイベントが発生した後にのみ呼び出されます。これは、ユーザーがTwitterに正常にログインしたことを示します。

レファレンス