ChannelMetadataBuilder
用于创建ChannelMetadata对象实例的生成器。
扩展
构造函数
new ChannelMetadataBuilder()
new ChannelMetadataBuilder():
ChannelMetadataBuilder
返回值
继承自
方法
attributes()
attributes(
attributes):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道属性。
参数
attributes
string[]
频道的属性。请参阅开发者指南，了解该字段的推荐规范值列表。该列表的最大大小为32。如果超过32个项目，多余的项目将被移除。每个项目的最大长度为255个字节，超过此长度的项目将被截断，最后3个字节将替换为“…”。
返回值
设置了频道属性的ChannelMetadataBuilder对象。
详情
对于频道元数据，此字段为选填。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
抛出
如果传入的字符串不是有效的UTF-8格式，则抛出InvalidArgumentError。
build()
build():
IChannelMetadata
根据ChannelMetadataBuilder中的字段构建ChannelMetadata对象。
返回值
构建的ChannelMetadata对象。
抛出
如果缺少一个或多个必填字段，则抛出InvalidArgumentError。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
覆盖
channelGroupId()
channelGroupId(
channelGroupId):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道组ID。
参数
channelGroupId
string
您的亚马逊联系人提供的频道组ID。该字段的最大长度为8,192个字节。
返回值
设置了channelGroupId的ChannelMetadataBuilder对象。
详情
此字段为可选项，通常不需要，除非您的亚马逊联系人建议返回。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
抛出
如果ExternId中的任何字段超过8,192个字节的最大长度，则抛出InvalidArgumentError。
抛出
如果传入的字符串不是有效的UTF-8格式，则抛出InvalidArgumentError。
channelType()
channelType(
channelType):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道类型。此字段只能设置为OTT，因为系统尚不支持其他频道类型。
参数
channelType
表示频道来源的频道类型。这必须是在ChannelTypeEnum中定义的来源之一。
返回值
设置了频道类型的ChannelMetadataBuilder对象。
详情
频道元数据需要此信息，因此必须返回此字段。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
externalIdList()
externalIdList(
externalIdList):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道ExternalId列表。
参数
externalIdList
外部时间表源的标识符列表，频道应该与之关联。列表的最大大小为255。如果超过255个项目，多余的项目将被移除。IExtrnalId中的字段的最大长度为8,192个字节。
返回值
设置了频道外部ID列表的ChannelMetadataBuilder对象。
详情
对于频道元数据，此字段为选填。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
抛出
如果ExternalId中的任何字段超过8,192个字节的最大长度，则抛出InvalidArgumentError。
抛出
如果传入的字符串不是有效的UTF-8格式，则抛出InvalidArgumentError。
genres()
genres(
genres):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道类型。
参数
genres
string[]
适用于频道的类型列表。请参阅开发者指南，了解该字段的推荐规范值列表。该列表的最大大小为32。如果超过32个项目，多余的项目将被移除。每个项目的最大长度为255个字节，超过此长度的项目将被截断，最后3个字节将替换为“…”。
返回值
设置了频道类型的ChannelMetadataBuilder对象。
详情
对于频道元数据，此字段为选填。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
抛出
如果传入的字符串不是有效的UTF-8格式，则抛出InvalidArgumentError。
logoUrl()
logoUrl(
logoUrl):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道标志URL。
参数
logoUrl
string
频道标志的URL。用于渲染频道缩略图。该字段的最大长度为8,192个字节。
返回值
设置了频道标志URL的ChannelMetadataBuilder对象。
详情
对于频道元数据，此字段为选填。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
抛出
如果该字段超过8,192个字节的最大长度，则抛出InvalidArgumentError。
抛出
如果传入的字符串不是有效的UTF-8格式，则抛出InvalidArgumentError。
name()
name(
name):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道名称。
参数
name
string
表示该频道的营销名称，例如“The CW”或“Comedy Central”。如果字符串的长度超过255个字节，则该字符串将被截断，并且最后3个字节将替换为“…”。
返回值
设置了频道名称的ChannelMetadataBuilder对象。
详情
频道元数据需要此信息，并且不能是空字符串。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
抛出
如果传入的字符串不是有效的UTF-8格式，则抛出InvalidArgumentError。
sortRank()
sortRank(
sortRank):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道排名。
参数
sortRank
number
该频道相对于其他频道的排名。在此应用的电子节目指南 (EPG) 中，排名值（整数）越小的频道越靠前显示。此字段为可选项，如果未提供，则默认为MAX Int32。如果您想根据频道的排名值显示频道，请联系您的亚马逊联系人。
返回值
设置了频道排名的ChannelMetadataBuilder对象。
详情
对于频道元数据，此字段为选填。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
videoResolution()
videoResolution(
videoResolution):ChannelMetadataBuilder
在ChannelMetadata生成器中设置频道视频分辨率。
参数
videoResolution
string
频道的视频分辨率。请参阅开发者指南，了解该字段的推荐规范值列表。如果字符串的长度超过127个字节，则该字符串将被截断，并且最后3个字节将替换为“…”。
返回值
设置了频道视频分辨率的ChannelMetadataBuilder对象。
详情
对于频道元数据，此字段为选填。
抛出
IllegalStateError：如果此生成器实例已经构建过一次对象，则再次调用此函数时会抛出该错误。
抛出
如果传入的字符串不是有效的UTF-8格式，则抛出InvalidArgumentError。
Last updated: 2025年9月30日
