鸿蒙OS开发文档 鸿蒙OS NotificationRequest.NotificationMediaContent

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 7

NotificationRequest.NotificationMediaContent

java.lang.Object
|---ohos.event.notification.NotificationRequest.NotificationMediaContent

public static final class NotificationRequest.NotificationMediaContent
extends Object
implements Sequenceable

构造一个可以与关联的音频会话交互的媒体播放通知。

在构造这个通知之前,你应该首先初始化一个 NotificationMediaContent 对象,并调用 setAVToken(ohos.media.common.sessioncore.AVToken) 为其附加一个 AVToken 以建立与关联的 AVSession 的交互通道。 您可以调用 [setShownActions(int]) 来请求在此通知中显示 NotificationActionButton 对象。 然后,您应该初始化一个 NotificationRequest 对象并调用 NotificationRequest#setContent(NotificationContent) 将其设置为媒体播放通知,并将先前构造的 NotificationMediaContent 对象附加到它。 此外,您应该调用 NotificationRequest#addActionButton(NotificationActionButton) 以便媒体控制按钮在此通知发布后显示在此通知中。

Since:

3

嵌套类摘要

从接口 ohos.utils.Sequenceable 继承的嵌套类/接口
Sequenceable.ProducerT

构造函数摘要

构造函数描述
NotificationMediaContent()用于创建 NotificationMediaContent 实例的默认构造函数。

方法总结

修饰符和类型方法描述
StringgetAdditionalText()通过为此媒体播放通知调用 setAdditionalText(java.lang.String) 获取已设置的附加文本。
AVTokengetAVToken()获取附加到此媒体播放通知的 AVToken。
int[]getShownActions()获取表示要在此媒体播放通知中显示的 NotificationActionButton 对象的序列号列表。
StringgetText()获取本次媒体播放通知调用 setText(java.lang.String) 设置的通知内容。
StringgetTitle()获取通过调用 setTitle(java.lang.String) 为该媒体播放通知设置的标题。
booleanmarshalling(Parcel out)将此 Notification Media Content 对象编组为 Parcel。
NotificationRequest.NotificationMediaContentsetAdditionalText(String additionalText)设置要包含在此媒体播放通知中的附加文本。
NotificationRequest.NotificationMediaContentsetAVToken(AVToken avToken)将指定的 AVToken 附加到此媒体播放通知。
NotificationRequest.NotificationMediaContentsetShownActions(int[] actions)设置最多三个 NotificationActionButton 对象以显示在此媒体播放通知中。
NotificationRequest.NotificationMediaContentsetText(String text)设置要包含在此媒体播放通知中的文本。
NotificationRequest.NotificationMediaContentsetTitle(String title)设置此媒体播放通知的标题。
StringtoString()返回对象的字符串表示形式。
booleanunmarshalling(Parcel in)从 Parcel 中解组此 NotificationMediaContent 对象。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
从接口 ohos.utils.Sequenceable 继承的方法
hasFileDescriptor

构造函数详细信息

NotificationMediaContent

public NotificationMediaContent()

用于创建 NotificationMediaContent 实例的默认构造函数。

Since:

3

方法详情

getTitle

public String getTitle()

获取通过调用 setTitle(java.lang.String) 为该媒体播放通知设置的标题。

返回:

返回此通知的标题。

Since:

3

setTitle

public NotificationRequest.NotificationMediaContent setTitle(String title)

设置此媒体播放通知的标题。

参数:

参数名称参数描述
title指示此媒体播放通知的标题。

返回:

返回此 NotificationMediaContent 对象。

Since:

3

getText

public String getText()

获取本次媒体播放通知调用 setText(java.lang.String) 设置的通知内容。

返回:

返回此通知的内容。

Since:

3

setText

public NotificationRequest.NotificationMediaContent setText(String text)

设置要包含在此媒体播放通知中的文本。

参数:

参数名称参数描述
text指示要包含的文本。

返回:

返回此 NotificationMediaContent 对象。

Since:

3

getAdditionalText

public String getAdditionalText()

通过为此媒体播放通知调用 setAdditionalText(java.lang.String) 获取已设置的附加文本。

返回:

返回此通知的附加文本。

Since:

3

setAdditionalText

public NotificationRequest.NotificationMediaContent setAdditionalText(String additionalText)

设置要包含在此媒体播放通知中的附加文本。

附加文本是对通过调用 setText(java.lang.String) 设置的通知文本的补充。 附加文本的字体小于通知文本,并在单独的行中显示。

参数:

参数名称参数描述
additionalText指示要包含的附加文本。

返回:

返回此 NotificationMediaContent 对象。

Since:

3

getAVToken

public AVToken getAVToken()

获取附加到此媒体播放通知的 AVToken。

返回:

返回附加到此通知的 AVToken。

Since:

3

setAVToken

public NotificationRequest.NotificationMediaContent setAVToken(AVToken avToken)

将指定的 AVToken 附加到此媒体播放通知。 附加 AVToken 后,此通知可以与关联的 AVSession 交互,以便用户可以在此通知中控制媒体播放。

参数:

参数名称参数描述
avToken指示要附加的 AVToken。

返回:

返回此 NotificationMediaContent 对象。

Since:

3

getShownActions

public int[] getShownActions()

获取表示要在此媒体播放通知中显示的 NotificationActionButton 对象的序列号列表。

返回:

返回表示要显示的操作按钮的序列号列表。

Since:

3

setShownActions

public NotificationRequest.NotificationMediaContent setShownActions(int[] actions)

设置最多三个 NotificationActionButton 对象以显示在此媒体播放通知中。

在发布该通知之前,还应调用 NotificationRequest#addActionButton(NotificationActionButton) 为该通知添加指定的 NotificationActionButton 对象,使该方法生效。 添加的操作按钮将按照添加的顺序分配序列号。 此方法的操作值中指定的序列号必须与分配给添加的操作按钮的序列号相匹配。 否则,通知将无法发布。 默认情况下,序列号从 0 开始。如果要显示三个操作按钮,则操作的值应为 0、1、2。

参数:

参数名称参数描述
actions指示表示要在此通知中显示的 NotificationActionButton 对象的序列号列表。

返回:

返回此 NotificationMediaContent 对象。

Since:

3

marshalling

public boolean marshalling(Parcel out)

将此 NotificationMediaContent 对象编组为 Parcel。

进程可以调用 unmarshalling(ohos.utils.Parcel) 方法从 Parcel 中解组此 NotificationMediaContent 对象,以实现进程间通信 (IPC)。

指定者:

接口 Sequenceable 中的编组

参数:

参数名称参数描述
out指示用于编组的 Parcel 对象。

返回:

如果编组成功,则返回 true; 否则返回 false。

Since:

3

unmarshalling

public boolean unmarshalling(Parcel in)

从 Parcel 中解组此 NotificationMediaContent 对象。

指定者:

在接口 Sequenceable 中解组

参数:

参数名称参数描述
in指示用于解组的 Parcel 对象。

返回:

如果解组成功,则返回 true; 否则返回 false。

Since:

3

toString

public String toString()

从类复制的描述:对象

返回对象的字符串表示形式。 通常,toString 方法返回一个“以文本方式表示”该对象的字符串。 结果应该是一个简洁但信息丰富的表示,易于人们阅读。 建议所有子类重写此方法。

Object 类的 toString 方法返回一个字符串,该字符串由对象作为其实例的类的名称、at 符号字符“@”和对象哈希码的无符号十六进制表示形式组成。 换句话说,此方法返回一个等于以下值的字符串:

getClass().getName() + '@' + Integer.toHexString(hashCode())

覆盖:

类 Object 中的 toString

返回:

对象的字符串表示形式。

Since:

4