ソーシャルコンポーネント
目次
連絡先
クリックすると、選択可能な連絡先のリストが表示されるボタン。 ユーザーが選択した後、選択した連絡先に関する情報に次のプロパティが設定されます。
ContactName
:連絡先の名前EmailAddress
:連絡先のメインのメールアドレスEmailAddressList
:連絡先のEメールアドレスのリストContactUri
:デバイス上の連絡先のURIPhoneNumber
:連絡先のメインの電話番号(後のAndroid Verisons上)PhoneNumberList
:連絡先の電話番号のリスト(後のAndroidバージョン)Picture
:連絡先の画像を含むファイルの名前ImageSprite
またはImageSprite
コンポーネントのPicture
プロパティ値として使用できます。
他のプロパティはボタンの外観( TextAlignment
、 BackgroundColor
など)とクリック可能かどうか( Enabled
)に影響します。
ContactPickerコンポーネントは、一部の電話機では機能しない可能性があります。 たとえば、システム3.0以前のAndroidシステムでは、電話番号を選択できず、電子メールアドレスのリストに含まれる電子メールは1つだけです。
プロパティ
BackgroundColor
ボタンの背景色を返しますContactName
EmailAddress
ContactUri
デバイス上の連絡先の場所を指定するURI。Enabled
FontBold
(デザイナーのみ)FontItalic
(デザイナーのみ)FontSize
(デザイナーのみ)FontTypeface
(デザイナーのみ)Height
Image
ボタンの画像のパスを指定します。 ImageとBackgroundColorの両方がある場合は、Imageだけが表示されます。Picture
Shape
(デザイナーのみ)ボタンの形状(デフォルト、丸み、長方形、楕円形)を指定します。 画像が表示されている場合、形状は表示されません。ShowFeedback
背景としての画像としてのボタンに対して視覚的なフィードバックを表示するかどうかを指定します。Text
TextAlignment
(デザイナーのみ)TextColor
Visible
コンポーネントを画面に表示するかどうかを指定します。 コンポーネントが表示されている場合は値はtrue、非表示になっている場合はfalseです。Width
イベント
AfterPicking()
ピッカーアクティビティが結果を返し、プロパティが入力された後に発生する単純なイベントです。BeforePicking()
コンポーネントがクリックされたとき、ピッカーアクティビティが開始される前に発生する単純なイベント。GotFocus()
カーソルがボタンの上に移動したため、クリックできるようになりました。LostFocus()
カーソルがボタンから移動したため、クリックできなくなったことを示します。
方法
Open()
ユーザーがクリックしたかのように、ピッカーを開きます。ViewContact(uri)
URIを指定して連絡先を表示します。
EmailPickerは一種のテキストボックスです。 ユーザーが連絡先の名前または電子メールアドレスの入力を開始すると、電話は入力を完了する選択肢のドロップダウンメニューを表示します。 多数の連絡先がある場合、ドロップダウンが表示されるまでに数秒かかることがあり、一致の計算中に中間結果が表示されることがあります。
テキストボックスの最初の内容とユーザー入力後の内容はText
プロパティにあります。 Text
プロパティが最初は空の場合、 Hint
プロパティの内容はテキストボックスにユーザーへのヒントとしてかすかに表示されます。
他のプロパティはテキストボックスの外観( TextAlignment
、 BackgroundColor
など)とそれが使用可能かどうか( Enabled
)に影響します。
このようなテキストボックスは通常Button
コンポーネントで使用され、ユーザーはテキスト入力が完了したときにボタンをクリックします。
方法
RequestFocus()
EmailPickerをアクティブにします。
プロパティ
BackgroundColor
入力ボックスの背景色。 デザイナまたはブロックエディタで名前を使って色を選択できます。 デフォルトの背景色は 'default’(3次元陰影)です。Enabled
ユーザーがこの入力ボックスにテキストを入力できるかどうか デフォルトでは、これは真です。FontBold
(デザイナーのみ)テキストのフォントを太字にするかどうか。 デフォルトでは、そうではありません。FontItalic
(デザイナーのみ)テキストを斜体で表示するかどうか。 デフォルトでは、そうではありません。FontSize
テキストのフォントサイズ。 デフォルトでは14.0ポイントです。FontTypeface
(デザイナーのみ)テキストのフォント 値はDesignerで変更できます。Height
Hint
ユーザーが何を入力すべきかについてのヒントを提供するために入力ボックスにかすかに表示されるべきテキスト。 これは、 Text
プロパティが空の場合にのみ表示されます。Text
入力ボックス内のテキスト。これは、DesignerまたはBlocks Editorでプログラマが設定することも、ユーザーが入力することもできます( Enabled
プロパティがfalseの場合を除く)。TextAlignment
(デザイナーのみ)テキストを左揃え、中央揃え、または右揃えにするかどうか。 デフォルトでは、テキストは左揃えになっています。TextColor
テキストの色 デザイナまたはブロックエディタで名前を使って色を選択できます。 デフォルトのテキスト色は黒です。Visible
コンポーネントを画面に表示するかどうかを指定します。 コンポーネントが表示されている場合は値はtrue、非表示になっている場合はfalseです。Width
イベント
GotFocus()
ユーザーがタッチするなどして、このコンポーネントが入力用に選択されたときに発生するイベント。LostFocus()
ユーザーが別のテキストボックスをタッチした場合など、このコンポーネントが入力用に選択されなくなったときに発生するイベント。
方法
無し
電話をかける
![](http://ai2.tmsoftwareinc.com/reference/components/images/phonecall.png)
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
ボタンの背景色を返しますContactName
EmailAddress
Enabled
FontBold
(デザイナーのみ)FontItalic
(デザイナーのみ)FontSize
(デザイナーのみ)FontTypeface
(デザイナーのみ)Height
Image
ボタンの画像のパスを指定します。 ImageとBackgroundColorの両方がある場合は、Imageだけが表示されます。PhoneNumber
Picture
Shape
(デザイナーのみ)ボタンの形状(デフォルト、丸み、長方形、楕円形)を指定します。 画像が表示されている場合、形状は表示されません。ShowFeedback
背景としての画像としてのボタンに対して視覚的なフィードバックを表示するかどうかを指定します。Text
TextAlignment
(デザイナーのみ)TextColor
Visible
コンポーネントを画面に表示するかどうかを指定します。 コンポーネントが表示されている場合は値は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)
利用可能なアプリのリストを表示し、そのリストからユーザーが選択できるようにすることで、電話機にインストールされている機能のあるアプリケーションを介してメッセージを共有します。 選択したアプリはメッセージが挿入された状態で開きます。
ショートメッセージ
![](http://ai2.tmsoftwareinc.com/reference/components/images/texting.png)
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
コンポーネントを含めることです。これを使用すると、ユーザーは電話の連絡先に保存されている電話番号から電話番号を選択できます。
プロパティ
GoogleVoiceEnabled
trueの場合、SendMessageはGoogle Voiceを使用してWifi経由でメッセージを送信しようとします。 これには、Google VoiceアプリをGoogle Voiceアカウントを使用して電話またはタブレットにインストールして設定する必要があります。 GoogleVoiceEnabledがfalseの場合、このコンポーネントとメッセージを送受信するには、デバイスに電話とテキストメッセージのサービスが必要です。 Google Voiceは米国内でのみ利用可能で、一部の電話ネットワークではサポートされていません。Message
SendMessageメソッドが呼び出されたときに送信されるメッセージ。 標準のSMSメッセージの最大長は通常170です。発音区別符号を使用している言語では、それより短くなることがあります。PhoneNumber
SendMessageメソッドが呼び出されたときにメッセージが送信される番号。 番号は指定された桁数のテキスト文字列です(例:6505551212)。 ダッシュ、ドット、および括弧を含めることができます(例:(650)-555-1212)が、無視されます。 スペースは含めないでください。ReceivingEnabled
1(オフ)に設定した場合、メッセージは受信されません。 2(FOREGROUND)または3(ALWAYS)に設定されている場合、コンポーネントは実行中の場合はメッセージに応答します。 2(FOREGROUND)の場合、アプリが実行されていない間に受信されたメッセージは破棄されます。 3(常に)の場合、アプリが実行されていない間にmessagess receiveが通知を表示します。 通知を選択するとアプリが起動し、MessageReceivedイベントが発生します。 アプリが休止しているときに受信したメッセージはキューに入れられるため、アプリが起動したときにいくつかのMessageReceivedイベントが表示されることがあります。 アプリ開発者として、このプロパティをユーザーに制御させることをお勧めします。そうすれば、アプリがインストールされたときに、ユーザーが自分の携帯電話にテキストメッセージを無視させることができます。
イベント
MessageReceived(text number, text messageText)
テキストメッセージが電話で受信されたときに発生するイベント。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。
方法
SendMessage()
メッセージと電話番号が事前に入力されている状態で、電話のデフォルトのテキストメッセージングアプリケーションを起動します。SendMessageDirect()
テキストメッセージを送る。 このブロックを使用すると、アプリがGoogle Playストアに送信された場合に追加の承認を必要とする危険な権限が追加されます。
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を取得する必要があります。
プロパティ
ConsumerKey
OAuthを介してTwitterで認証するときに使用される消費者キー。ConsumerSecret
OAuthを介してTwitterで認証するときに使用される消費者秘密DirectMessages
このプロパティには、ログインユーザーに言及している最新のメッセージのリストが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません。
Authorize
メソッドを呼び出します。Authorized
イベントを待ちます。RequestDirectMessages
メソッドを呼び出します。DirectMessagesReceived
イベントを待ちます。
このプロパティの値は、取得されたダイレクトメッセージのリストに設定されます(そしてその後のRequestDirectMessages
呼び出しまでその値を維持します)。Followers
このプロパティには、ログインユーザーのフォロワーのリストが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません。
Authorize
メソッドを呼び出します。IsAuthorized
イベントを待ちます。RequestFollowers
メソッドを呼び出します。FollowersReceived
イベントを待ちます。
このプロパティの値は、フォロワーのリストに設定されます(そして、その後のRequestFollowers
への呼び出しまでその値を維持します)。FriendTimeline
このプロパティには、フォローされているユーザーの最新の20件のメッセージが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません。
Authorize
メソッドを呼び出します。IsAuthorized
イベントを待ちます。Follow
メソッドへの1つ以上の呼び出しでフォローするユーザーを指定します。RequestFriendTimeline
メソッドを呼び出します。FriendTimelineReceived
イベントを待ちます。
このプロパティの値はメッセージのリストに設定されます(そして、その後のRequestFriendTimeline
への呼び出しまでその値を維持します)。Mentions
このプロパティにはログインユーザのメンションのリストが含まれています。 最初は、リストは空です。 それを設定するために、プログラムは以下を行わなければなりません
Authorize
メソッドを呼び出します。IsAuthorized
イベントを待ちます。RequestMentions
メソッドを呼び出します。MentionsReceived
イベントを待ちます。
このプロパティの値は、次にメンションのリストに設定されます(そして、その後のRequestMentions
呼び出しまでその値を維持します)。SearchResults
このプロパティは、最初は空ですが、プログラムの実行後に検索結果のリストに設定されます。
SearchTwitter
メソッドを呼び出します。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に正常にログインしたことを示します。