public static class ShareCompat.IntentReader
extends Object
java.lang.Object | |
↳ | android.support.v4.app.ShareCompat.IntentReader |
IntentReader是读取共享(ACTION_SEND)意图中包含的数据的助手。 它提供了解析共享中包含的标准元素的方法,以及关于共享内容的应用程序的额外元数据。
鼓励社交分享应用为共享内容的应用提供归因。 IntentReader提供对应用程序标签的访问,调用共享内容的应用程序的活动信息和应用程序图标。 这些数据可能由呼叫应用程序自愿提供,并且在提交手动验证之前应始终显示给用户。 如果需要,应该向用户提供从共享帖子中省略此信息的选项。
打算接收共享意图的活动应该配置一个意图过滤器来接受 ACTION_SEND
意图(“android.intent.action.SEND”),并且如果活动具备处理活动的 ACTION_SEND_MULTIPLE
(可选)接受 ACTION_SEND_MULTIPLE
(“android.intent.action.SEND_MULTIPLE”)多个数据流。
Public methods |
|
---|---|
static ShareCompat.IntentReader |
from(Activity activity) 获取一个IntentReader,用于解析和解释用于启动给定活动的共享意图。 |
ComponentName |
getCallingActivity() 获取调用此共享意图的Activity的 |
Drawable |
getCallingActivityIcon() 如果有关调用活动的数据可用,请将调用活动的图标作为Drawable获取。 |
Drawable |
getCallingApplicationIcon() 如果有关调用包的数据可用,请将调用应用程序的图标作为Drawable获取。 |
CharSequence |
getCallingApplicationLabel() 如果有关调用包的数据可用,请获取调用应用程序的人类可读标签(标题)。 |
String |
getCallingPackage() 获取调用此共享意图的包的名称。 |
String[] |
getEmailBcc() 获取一串字符串,每个字符串都是BCC上的电子邮件地址。 |
String[] |
getEmailCc() 获取一串字符串,每个字符串都是CC上的电子邮件地址。 |
String[] |
getEmailTo() 获取一串字符串,每个字符串都要分享给一个电子邮件地址。 |
String |
getHtmlText() 获取与目标活动共享的样式化HTML文本。 |
Uri |
getStream(int index) 获取与目标活动共享的流项目的URI。 |
Uri |
getStream() 获取引用与目标活动共享的数据流的URI。 |
int |
getStreamCount() 返回共享的流项目的数量。 |
String |
getSubject() 获取此份额的主题标题; 通过电子邮件分享时很有用 |
CharSequence |
getText() 获取与目标活动共享的文字文本。 |
String |
getType() 获取与此活动共享的数据的mimetype。 |
boolean |
isMultipleShare() 如果此读者获得的活动是以 |
boolean |
isShareIntent() 如果此读者获得的活动 |
boolean |
isSingleShare() 如果此读者获得的活动是以 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
ShareCompat.IntentReader from (Activity activity)
获取一个IntentReader,用于解析和解释用于启动给定活动的共享意图。
Parameters | |
---|---|
activity |
Activity : Activity that was started to share content |
Returns | |
---|---|
ShareCompat.IntentReader |
IntentReader for parsing sharing data |
ComponentName getCallingActivity ()
获取调用此共享意图的Activity的ComponentName
。 如果目标共享活动未启动,IntentBuilder将从ShareBuilder的意图中读取额外的元数据。
注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。
Returns | |
---|---|
ComponentName |
ComponentName of the calling Activity or null if unknown |
Drawable getCallingActivityIcon ()
如果有关调用活动的数据可用,请将调用活动的图标作为Drawable获取。
注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。
Returns | |
---|---|
Drawable |
The calling Activity's icon or null if unknown |
Drawable getCallingApplicationIcon ()
如果有关调用包的数据可用,请将调用应用程序的图标作为Drawable获取。
注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。
Returns | |
---|---|
Drawable |
The calling application's icon or null if unknown |
CharSequence getCallingApplicationLabel ()
如果有关调用包的数据可用,请获取调用应用程序的人类可读标签(标题)。
注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。
Returns | |
---|---|
CharSequence |
The calling application's label or null if unknown |
String getCallingPackage ()
获取调用此共享意图的包的名称。 如果结果没有开始活动,IntentBuilder将从ShareBuilder的Intent中放置的额外元数据中读取它。
注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。
Returns | |
---|---|
String |
Name of the package that started this activity or null if unknown |
String[] getEmailBcc ()
获取一串字符串,每个字符串都是BCC上的电子邮件地址。
Returns | |
---|---|
String[] |
An array of email addresses or null if none were supplied. |
也可以看看:
String[] getEmailCc ()
获取一串字符串,每个字符串都是CC上的电子邮件地址。
Returns | |
---|---|
String[] |
An array of email addresses or null if none were supplied. |
也可以看看:
String[] getEmailTo ()
获取一串字符串,每个字符串都要分享给一个电子邮件地址。
Returns | |
---|---|
String[] |
An array of email addresses or null if none were supplied. |
也可以看看:
String getHtmlText ()
获取与目标活动共享的样式化HTML文本。 如果没有提供HTML文本,但EXTRA_TEXT
包含样式文本,它将被转换为HTML并返回。 如果EXTRA_TEXT
提供的文本没有文字样式,则会被escapeHtml(CharSequence)
转义并返回。 如果根本没有提供文本,则此方法将返回空值。
Returns | |
---|---|
String |
Styled text provided by the sender as HTML. |
Uri getStream (int index)
获取与目标活动共享的流项目的URI。 索引应该在[0-getStreamCount())范围内。
Parameters | |
---|---|
index |
int : Index of text item to retrieve |
Returns | |
---|---|
Uri |
Requested stream item URI |
也可以看看:
Uri getStream ()
获取引用与目标活动共享的数据流的URI。
如果共享意图包含多个流项目,则此调用将失败。 如果isMultipleShare()
返回true,则应用程序应使用getStream(int)
和getStreamCount()
检索包含的流项目。
Returns | |
---|---|
Uri |
A URI referring to a data stream to be shared or null if one was not supplied |
也可以看看:
int getStreamCount ()
返回共享的流项目的数量。 返回值将是0或1,如果这是一个ACTION_SEND
意图,或0或更多,如果它是一个ACTION_SEND_MULTIPLE
意图。
Returns | |
---|---|
int |
Count of text items contained within the Intent |
String getSubject ()
获取此份额的主题标题; 通过电子邮件分享时很有用
Returns | |
---|---|
String |
The subject heading for this share or null if one was not supplied. |
也可以看看:
CharSequence getText ()
获取与目标活动共享的文字文本。
Returns | |
---|---|
CharSequence |
Literal shared text or null if none was supplied |
也可以看看:
boolean isMultipleShare ()
如果此读者获得的活动是以ACTION_SEND_MULTIPLE
意图开始的,则返回true。 意图可能包含多个流项目。
Returns | |
---|---|
boolean |
true if the activity was started with an ACTION_SEND_MULTIPLE intent |
boolean isShareIntent ()
如果此读者获得的活动 ACTION_SEND_MULTIPLE
共享意图 ACTION_SEND
或 ACTION_SEND_MULTIPLE
,则返回true。
Returns | |
---|---|
boolean |
true if the activity was started with an ACTION_SEND or ACTION_SEND_MULTIPLE Intent |
boolean isSingleShare ()
如果此读者获得的活动是以ACTION_SEND
意图开始并包含单个共享项目,则返回true。 应根据共享内容的类型使用getText()
或getStream()
方法获取共享内容。
Returns | |
---|---|
boolean |
true if the activity was started with an ACTION_SEND intent |