Most visited

Recently visited

ShareCompat.IntentReader

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”)多个数据流。

Summary

Public methods

static ShareCompat.IntentReader from(Activity activity)

获取一个IntentReader,用于解析和解释用于启动给定活动的共享意图。

ComponentName getCallingActivity()

获取调用此共享意图的Activity的 ComponentName

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()

如果此读者获得的活动是以 ACTION_SEND_MULTIPLE意图开始的,则返回true。

boolean isShareIntent()

如果此读者获得的活动 ACTION_SEND_MULTIPLE共享意图 ACTION_SENDACTION_SEND_MULTIPLE ,则返回true。

boolean isSingleShare()

如果此读者获得的活动是以 ACTION_SEND意图开始并包含单个共享项目,则返回true。

Inherited methods

From class java.lang.Object

Public methods

from

ShareCompat.IntentReader from (Activity activity)

获取一个IntentReader,用于解析和解释用于启动给定活动的共享意图。

Parameters
activity Activity: Activity that was started to share content
Returns
ShareCompat.IntentReader IntentReader for parsing sharing data

getCallingActivity

ComponentName getCallingActivity ()

获取调用此共享意图的Activity的ComponentName 如果目标共享活动未启动,IntentBuilder将从ShareBuilder的意图中读取额外的元数据。

注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。

Returns
ComponentName ComponentName of the calling Activity or null if unknown

也可以看看:

getCallingActivityIcon

Drawable getCallingActivityIcon ()

如果有关调用活动的数据可用,请将调用活动的图标作为Drawable获取。

注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。

Returns
Drawable The calling Activity's icon or null if unknown

getCallingApplicationIcon

Drawable getCallingApplicationIcon ()

如果有关调用包的数据可用,请将调用应用程序的图标作为Drawable获取。

注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。

Returns
Drawable The calling application's icon or null if unknown

getCallingApplicationLabel

CharSequence getCallingApplicationLabel ()

如果有关调用包的数据可用,请获取调用应用程序的人类可读标签(标题)。

注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。

Returns
CharSequence The calling application's label or null if unknown

getCallingPackage

String getCallingPackage ()

获取调用此共享意图的包的名称。 如果结果没有开始活动,IntentBuilder将从ShareBuilder的Intent中放置的额外元数据中读取它。

注意:这些数据可能是由主叫应用程序自愿提供的。 因此,在安全或验证环境中,不应该信任其准确性。

Returns
String Name of the package that started this activity or null if unknown

也可以看看:

getEmailBcc

String[] getEmailBcc ()

获取一串字符串,每个字符串都是BCC上的电子邮件地址。

Returns
String[] An array of email addresses or null if none were supplied.

也可以看看:

getEmailCc

String[] getEmailCc ()

获取一串字符串,每个字符串都是CC上的电子邮件地址。

Returns
String[] An array of email addresses or null if none were supplied.

也可以看看:

getEmailTo

String[] getEmailTo ()

获取一串字符串,每个字符串都要分享给一个电子邮件地址。

Returns
String[] An array of email addresses or null if none were supplied.

也可以看看:

getHtmlText

String getHtmlText ()

获取与目标活动共享的样式化HTML文本。 如果没有提供HTML文本,但EXTRA_TEXT包含样式文本,它将被转换为HTML并返回。 如果EXTRA_TEXT提供的文本没有文字样式,则会被escapeHtml(CharSequence)转义并返回。 如果根本没有提供文本,则此方法将返回空值。

Returns
String Styled text provided by the sender as HTML.

getStream

Uri getStream (int index)

获取与目标活动共享的流项目的URI。 索引应该在[0-getStreamCount())范围内。

Parameters
index int: Index of text item to retrieve
Returns
Uri Requested stream item URI

也可以看看:

getStream

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

也可以看看:

getStreamCount

int getStreamCount ()

返回共享的流项目的数量。 返回值将是0或1,如果这是一个ACTION_SEND意图,或0或更多,如果它是一个ACTION_SEND_MULTIPLE意图。

Returns
int Count of text items contained within the Intent

getSubject

String getSubject ()

获取此份额的主题标题; 通过电子邮件分享时很有用

Returns
String The subject heading for this share or null if one was not supplied.

也可以看看:

getText

CharSequence getText ()

获取与目标活动共享的文字文本。

Returns
CharSequence Literal shared text or null if none was supplied

也可以看看:

getType

String getType ()

获取与此活动共享的数据的mimetype。

Returns
String mimetype of the shared data

也可以看看:

isMultipleShare

boolean isMultipleShare ()

如果此读者获得的活动是以ACTION_SEND_MULTIPLE意图开始的,则返回true。 意图可能包含多个流项目。

Returns
boolean true if the activity was started with an ACTION_SEND_MULTIPLE intent

isShareIntent

boolean isShareIntent ()

如果此读者获得的活动 ACTION_SEND_MULTIPLE共享意图 ACTION_SENDACTION_SEND_MULTIPLE ,则返回true。

Returns
boolean true if the activity was started with an ACTION_SEND or ACTION_SEND_MULTIPLE Intent

isSingleShare

boolean isSingleShare ()

如果此读者获得的活动是以ACTION_SEND意图开始并包含单个共享项目,则返回true。 应根据共享内容的类型使用getText()getStream()方法获取共享内容。

Returns
boolean true if the activity was started with an ACTION_SEND intent

Hooray!