public static final class TvTrackInfo.Builder
extends Object
| java.lang.Object | |
| android.media.tv.TvTrackInfo.Builder | |
用于创建 TvTrackInfo对象的构建器类。
Public constructors |
|
|---|---|
TvTrackInfo.Builder(int type, String id) 创建一个 |
|
公共方法(Public methods) |
|
|---|---|
TvTrackInfo |
build() 用指定的字段创建一个 |
final TvTrackInfo.Builder |
setAudioChannelCount(int audioChannelCount) 设置音频通道计数。 |
final TvTrackInfo.Builder |
setAudioSampleRate(int audioSampleRate) 设置音频采样率,以Hz为单位。 |
final TvTrackInfo.Builder |
setDescription(CharSequence description) 为当前曲目设置用户可读的描述。 |
final TvTrackInfo.Builder |
setExtra(Bundle extra) 设置关于当前曲目的额外信息。 |
final TvTrackInfo.Builder |
setLanguage(String language) 设置当前曲目的语言信息。 |
final TvTrackInfo.Builder |
setVideoActiveFormatDescription(byte videoActiveFormatDescription) 设置视频的活动格式描述(AFD)代码。 |
final TvTrackInfo.Builder |
setVideoFrameRate(float videoFrameRate) 设置视频的帧速率,单位为fps(帧速率)。 |
final TvTrackInfo.Builder |
setVideoHeight(int videoHeight) 以像素为单位设置视频的高度。 |
final TvTrackInfo.Builder |
setVideoPixelAspectRatio(float videoPixelAspectRatio) 设置视频的像素宽高比(像素宽度与其高度的比率)。 |
final TvTrackInfo.Builder |
setVideoWidth(int videoWidth) 以像素为单位设置视频的宽度。 |
继承方法(Inherited methods) |
|
|---|---|
java.lang.Object
|
|
TvTrackInfo.Builder (int type,
String id)
创建一个TvTrackInfo.Builder 。 必须添加应包含在TvTrackInfo中的任何字段。
| 参数(Parameters) | |
|---|---|
type |
int: The type of the track. |
id |
String: The ID of the track that uniquely identifies the current track among all the other tracks in the same TV program. |
| 抛出异常(Throws) | |
|---|---|
IllegalArgumentException |
if the type is not any of TYPE_AUDIO, TYPE_VIDEO and TYPE_SUBTITLE |
TvTrackInfo build ()
用指定的字段创建一个 TvTrackInfo实例。
| 返回(Returns) | |
|---|---|
TvTrackInfo |
The new TvTrackInfo instance |
TvTrackInfo.Builder setAudioChannelCount (int audioChannelCount)
设置音频通道计数。 仅适用于TYPE_AUDIO曲目。
| 参数(Parameters) | |
|---|---|
audioChannelCount |
int: The audio channel count. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalStateException |
if not called on an audio track |
TvTrackInfo.Builder setAudioSampleRate (int audioSampleRate)
设置音频采样率,以Hz为单位。 仅适用于TYPE_AUDIO曲目。
| 参数(Parameters) | |
|---|---|
audioSampleRate |
int: The audio sample rate. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalStateException |
if not called on an audio track |
TvTrackInfo.Builder setDescription (CharSequence description)
为当前曲目设置用户可读的描述。
| 参数(Parameters) | |
|---|---|
description |
CharSequence: The user readable description. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
TvTrackInfo.Builder setExtra (Bundle extra)
设置关于当前曲目的额外信息。
| 参数(Parameters) | |
|---|---|
extra |
Bundle: The extra information. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
TvTrackInfo.Builder setLanguage (String language)
设置当前曲目的语言信息。
| 参数(Parameters) | |
|---|---|
language |
String: The language string encoded by either ISO 639-1 or ISO 639-2/T. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
TvTrackInfo.Builder setVideoActiveFormatDescription (byte videoActiveFormatDescription)
设置视频的活动格式描述(AFD)代码。 仅适用于TYPE_VIDEO曲目。
这是应用程序需要根据有效视频的编码图像中的哪个位置的信息来正确缩放视频所需的。 ETSI TS 101 154 V1.7.1附件B,ATSC A / 53第4部分和SMPTE 2016-1-2007中定义了完整的值列表。
| 参数(Parameters) | |
|---|---|
videoActiveFormatDescription |
byte: The AFD code of the video. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalStateException |
if not called on a video track |
TvTrackInfo.Builder setVideoFrameRate (float videoFrameRate)
设置视频的帧速率,单位为fps(帧速率)。 仅适用于TYPE_VIDEO曲目。
| 参数(Parameters) | |
|---|---|
videoFrameRate |
float: The frame rate of the video. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalStateException |
if not called on a video track |
TvTrackInfo.Builder setVideoHeight (int videoHeight)
以像素为单位设置视频的高度。 仅适用于TYPE_VIDEO曲目。
| 参数(Parameters) | |
|---|---|
videoHeight |
int: The height of the video. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalStateException |
if not called on a video track |
TvTrackInfo.Builder setVideoPixelAspectRatio (float videoPixelAspectRatio)
设置视频的像素宽高比(像素宽度与其高度的比率)。 仅适用于TYPE_VIDEO曲目。
这对于应用程序能够正确地缩放一些视频格式,例如像素不是方形的720x576 4:3和720x576 16:9而言是必需的。 默认情况下,应用程序假定值为1.0(方形像素),因此不需要为大多数视频格式设置像素宽高比。
| 参数(Parameters) | |
|---|---|
videoPixelAspectRatio |
float: The pixel aspect ratio of the video. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalStateException |
if not called on a video track |
TvTrackInfo.Builder setVideoWidth (int videoWidth)
以像素为单位设置视频的宽度。 仅适用于TYPE_VIDEO曲目。
| 参数(Parameters) | |
|---|---|
videoWidth |
int: The width of the video. |
| 返回(Returns) | |
|---|---|
TvTrackInfo.Builder |
|
| 抛出异常(Throws) | |
|---|---|
IllegalStateException |
if not called on a video track |