媒体源扩展™ (Media Source Extensions™)

本规范的设计旨在实现以下目标：

允许 JavaScript 构建媒体流，而与媒体的获取方式无关。
定义一种拼接和缓冲模型，以促进自适应流媒体、广告插入、时移和视频编辑等用例。
最大限度地减少 JavaScript 中媒体解析的需求。
尽可能利用浏览器缓存。
为字节流格式规范提供需求。
不要求支持任何特定的媒体格式或编解码器。

本规范定义了：

用户代理在处理媒体数据时，为实现用户代理与 Web 应用程序之间的互操作性所需的规范行为。
使其他规范能够定义在本规范内使用的媒体格式的规范要求。

活动轨道缓冲区 (Active Track Buffers)

提供编码帧的轨道缓冲区，用于 enabled 的 audioTracks、selected 的 videoTracks，以及 "showing" 或 "hidden" 的 textTracks。所有这些轨道都关联到 SourceBuffer 对象在 activeSourceBuffers 列表中。

追加窗口 (Append Window)

一种用于在追加时过滤编码帧的表示时间戳范围。追加窗口表示一个具有单一开始时间和结束时间的连续时间范围。在此范围内的表示时间戳的编码帧被允许追加到 SourceBuffer 中，而超出此范围的编码帧则被过滤掉。追加窗口的开始和结束时间分别由 appendWindowStart 和 appendWindowEnd 属性控制。

编码帧 (Coded Frame)

一种媒体数据单元，具有表示时间戳、解码时间戳和编码帧持续时间。

编码帧持续时间 (Coded Frame Duration)

编码帧的持续时间。对于视频和文本，持续时间指示视频帧或文本应当显示的时长。对于音频，持续时间表示编码帧内包含的所有采样的总和。例如，如果一个音频帧包含 441 个采样，采样率为 44100Hz，则帧持续时间为 10 毫秒。

编码帧结束时间戳 (Coded Frame End Timestamp)

编码帧表示时间戳与其编码帧持续时间之和。它表示紧随该编码帧之后的表示时间戳。

编码帧组 (Coded Frame Group)

一组相邻且具有单调递增解码时间戳且中间没有任何间隙的编码帧。编码帧处理算法和 abort() 调用检测到的不连续性会触发新的编码帧组的开始。

解码时间戳 (Decode Timestamp)

解码时间戳指示该帧需要被解码的最晚时间（假设该帧及任何依赖帧的瞬时解码和渲染，这等于表示顺序中依赖于该帧的最早帧的表示时间戳）。如果帧可以按非表示顺序解码，则解码时间戳必须存在于或可从字节流中导出。如果不是这种情况，用户代理必须运行追加错误算法。如果帧不能按非表示顺序解码且字节流中不存在解码时间戳，则解码时间戳等于表示时间戳。

初始化段 (Initialization Segment)

包含解码一系列媒体段所需的所有初始化信息的字节序列。这包括编解码器初始化数据、多路复用段的轨道 ID 映射以及时间戳偏移（例如编辑列表）。

注

字节流格式注册表 [MSE-REGISTRY] 中的字节流格式规范包含格式特定的示例。

媒体段 (Media Segment)

包含媒体时间轴一部分的分组且带时间戳的媒体数据的字节序列。媒体段始终与最近追加的初始化段相关联。

注

字节流格式注册表 [MSE-REGISTRY] 中的字节流格式规范包含格式特定的示例。

MediaSource 对象 URL

MediaSource 对象 URL 是由 createObjectURL() 创建的唯一 blob URL。它用于将 MediaSource 对象附加到 HTMLMediaElement。

这些 URL 与 blob URL 相同，只是该功能定义中引用 File 和 Blob 对象的任何内容，现特此扩展为也适用于 MediaSource 对象。

MediaSource 对象 URL 的源 (origin) 是在调用 createObjectURL() 时此对象的相关设置对象。

注

例如，MediaSource 对象 URL 的源 (origin) 会影响媒体元素被 canvas 使用的方式。

父媒体源 (Parent Media Source)

SourceBuffer 对象的父媒体源是创建它的 MediaSource 对象。

表示开始时间 (Presentation Start Time)

表示开始时间是呈现中的最早时间点，并指定初始播放位置和最早可能位置。使用本规范创建的所有呈现的表示开始时间均为 0。

注

为了确定 HTMLMediaElement 的 buffered 是否包含一个涵盖当前播放位置的 TimeRanges，实现可以选择允许在表示开始时间之后和第一个 TimeRanges 之前的当前播放位置，如果该 TimeRanges 在表示开始时间后经过很短的时间（例如 1 秒）内开始，则可以播放该第一个 TimeRanges。此允许照顾了多路复用流通常不会在表示开始时间处精确开始所有轨道的现实。无论此项允许如何，实现必须报告实际的缓冲范围。

表示区间 (Presentation Interval)

编码帧的表示区间是从其表示时间戳到表示时间戳加上编码帧持续时间的时间区间。例如，如果一个编码帧的表示时间戳为 10 秒，编码帧持续时间为 100 毫秒，则表示区间为 [10-10.1)。注意，区间的开始是包含的，但结尾是排他的。

表示顺序 (Presentation Order)

编码帧在呈现中渲染的顺序。表示顺序是通过按表示时间戳单调递增的顺序对编码帧进行排序来实现的。

表示时间戳 (Presentation Timestamp)

对呈现中特定时间的引用。编码帧中的表示时间戳指示帧应当被渲染的时间。

随机访问点 (Random Access Point)

媒体段中的一个位置，在该位置可以开始解码和连续播放，而无需依赖段中的任何先前数据。对于视频，这通常是 I 帧的位置。对于音频，大多数音频帧都可以视为随机访问点。由于视频轨道倾向于具有更稀疏的随机访问点分布，这些点的位置通常被视为多路复用流的随机访问点。

SourceBuffer 字节流格式规范

描述 SourceBuffer 实例所接受的字节流格式的特定字节流格式规范。SourceBuffer 对象的字节流格式规范最初是根据创建该对象的 addSourceBuffer() 调用中传入的 type 选择的，并且可以通过该对象上的 changeType() 调用进行更新。

SourceBuffer 配置

分布在单个 MediaSource 实例拥有的一个或多个 SourceBuffer 对象中的特定轨道集。

实现必须支持至少 1 个 MediaSource 对象，并具备以下配置：

具有 1 个音频轨道和/或 1 个视频轨道的单个 SourceBuffer。
两个 SourceBuffer，一个处理单个音频轨道，另一个处理单个视频轨道。

MediaSource 对象必须支持上述每种配置，但它们仅被要求一次支持一种配置。同时支持多种配置或额外配置属于实现质量问题。

轨道描述 (Track Description)

一种字节流格式特定的结构，为单个轨道提供轨道 ID、编解码器配置和其他元数据。单个初始化段内的每个轨道描述都有一个唯一的轨道 ID。如果轨道 ID 在初始化段内不唯一，则用户代理必须运行追加错误算法。

轨道 ID (Track ID)

轨道 ID 是一种字节流格式特定的标识符，将字节流的部分标记为特定轨道的一部分。轨道描述中的轨道 ID 标识媒体段的哪些部分属于该轨道。

MediaSource 接口代表 HTMLMediaElement 的媒体数据源。它跟踪该源的 readyState，以及可用于向呈现中添加媒体数据的 SourceBuffer 对象列表。MediaSource 对象由 Web 应用程序创建，然后附加到 HTMLMediaElement。应用程序使用 sourceBuffers 中的 SourceBuffer 对象向此源添加媒体数据。HTMLMediaElement 在播放期间需要时会从 MediaSource 对象获取此媒体数据。

每个 MediaSource 对象都有一个存储标准化 TimeRanges 对象的 [[实时可跳转范围]] 内部槽。它在创建 MediaSource 对象时被初始化为一个空的 TimeRanges 对象，由 setLiveSeekableRange() 和 clearLiveSeekableRange() 维护，并用于 10. HTMLMediaElement 扩展以修改 HTMLMediaElement 的 seekable 行为。

每个 MediaSource 对象都有一个存储 boolean 的 [[是否曾被附加]] 内部槽。它在创建 MediaSource 对象时被初始化为 false，并如附加到媒体元素算法中所述，在扩展的 HTMLMediaElement 的资源获取算法中被设置为 true。扩展的资源获取算法使用此内部槽有条件地拒绝附加使用 HTMLMediaElement 的 srcObject 属性上设置的 MediaSourceHandle 的 MediaSource。

WebIDLenum ReadyState {
  "closed",
  "open",
  "ended",
};

closed: 指示该源当前未附加到媒体元素。
开启: 该源已被媒体元素打开，并准备好将数据追加到 MediaSource 的 sourceBuffers 中的 SourceBuffer 对象。
ended: 该源仍附加到媒体元素，但已调用 MediaSource 的 endOfStream()。

Issue 276: MSE-in-Workers: 考虑添加一个 "closing" readyState，以解释在关闭过程中发生新的 `InvalidStateError` 异常的情况 mse-in-workers

WebIDLenum EndOfStreamError {
  "network",
  "decode",
};

network: 终止播放并发出网络错误已发生的信号。

注
JavaScript 应用程序应当使用此状态码来终止播放并报告网络错误。例如，如果获取媒体数据时发生网络错误。
decode: 终止播放并发出解码错误已发生的信号。

注
JavaScript 应用程序应当使用此状态码来终止播放并报告解码错误。例如，如果处理带外媒体数据时发生解析错误。

WebIDL[Exposed=(Window,DedicatedWorker)]
interface MediaSource : EventTarget {
    constructor();

    [SameObject, Exposed=DedicatedWorker]
    readonly  attribute MediaSourceHandle handle;
    readonly  attribute SourceBufferList sourceBuffers;
    readonly  attribute SourceBufferList activeSourceBuffers;
    readonly  attribute ReadyState readyState;

    attribute unrestricted double duration;
    attribute EventHandler onsourceopen;
    attribute EventHandler onsourceended;
    attribute EventHandler onsourceclose;

    static readonly attribute boolean canConstructInDedicatedWorker;

    SourceBuffer addSourceBuffer(DOMString type);
    undefined removeSourceBuffer(SourceBuffer sourceBuffer);
    undefined endOfStream(optional EndOfStreamError error);
    undefined setLiveSeekableRange(double start, double end);
    undefined clearLiveSeekableRange();
    static boolean isTypeSupported(DOMString type);
};

包含一个句柄，用于将专用 worker 中的 MediaSource 对象通过 srcObject 附加到 HTMLMediaElement。对于此 MediaSource 对象，句柄在多次访问此属性时保持为同一个对象，但对于每个 MediaSource 对象，它是唯一的。

注

本规范最终可能会启用主 Window 上下文中 MediaSource 对象对此属性的可视性。如果这样，需要规范上的谨慎处理，以防止潜在的向后不兼容变更，例如如果访问此属性时抛出异常可能发生的情况。

获取时，运行以下步骤：

如果尚未为此 MediaSource 对象创建句柄，则运行以下步骤：
1. 令 创建的句柄 为创建新的 MediaSourceHandle 对象和关联资源的结果，并在内部链接到此 MediaSource。
2. 更新该属性为 创建的句柄。
返回作为此属性值的 MediaSourceHandle 对象。

包含与此 MediaSource 关联的 SourceBuffer 对象列表。当 MediaSource 的 readyState 等于 "closed" 时，此列表将为空。一旦 readyState 过渡到 "open"，就可以使用 addSourceBuffer() 将 SourceBuffer 对象添加到此列表中。

包含 sourceBuffers 的子集，这些缓冲区提供了 selected 视频轨道、enabled 的音频轨道以及 "showing" 或 "hidden" 的文本轨道。

此列表中的 SourceBuffer 对象必须以它们在 sourceBuffers 属性中出现的相同顺序出现；例如，如果只有 sourceBuffers[0] 和 sourceBuffers[3] 在 activeSourceBuffers 中，则 activeSourceBuffers[0] 必须等于 sourceBuffers[0]，并且 activeSourceBuffers[1] 必须等于 sourceBuffers[3]。

注

3.15.5 选定/启用轨道状态的变更章节描述了如何更新此属性。

指示 MediaSource 对象的当前状态。当创建 MediaSource 时，readyState 必须被设置为 "closed"。

允许 Web 应用程序设置呈现时长。当创建 MediaSource 对象时，时长最初设置为 NaN。

获取时，运行以下步骤：

如果 readyState 属性为 "closed"，则返回 NaN 并中止这些步骤。
返回该属性的当前值。

设置时，执行以下步骤：

如果设置的值为负数或 NaN，则抛出 TypeError 异常并中止这些步骤。
如果 readyState 属性不为 "open"，则抛出 InvalidStateError 异常并中止这些步骤。
如果 sourceBuffers 中的任何 SourceBuffer 的 updating 属性等于 true，则抛出 InvalidStateError 异常并中止这些步骤。
运行时长变更算法，将 新时长 设置为分配给此属性的值。
注
时长变更算法将调整 新时长 更高，如果存在任何当前缓冲的、具有更高结束时间的编码帧。

注
appendBuffer() 和 endOfStream() 在特定情况下可以更新时长。

返回 true。

注

此属性支持主线程和专用 worker 对在专用 worker 中创建和使用 MediaSource 对象的支持情况进行特征检测，并缓解了对高延迟检测 polyfill 的需求（例如尝试从专用 worker 创建 MediaSource 对象，特别是如果不支持该功能时）。

将新的 SourceBuffer 添加到 sourceBuffers。

如果 type 是一个空字符串，则抛出 TypeError 异常并中止这些步骤。
如果 type 包含不支持的 MIME 类型，或者包含与 sourceBuffers 中其他 SourceBuffer 对象指定的类型不兼容的 MIME 类型，则抛出 NotSupportedError 异常并中止这些步骤。
如果用户代理无法处理更多的 SourceBuffer 对象，或者基于 type 创建 SourceBuffer 会导致不支持的 SourceBuffer 配置，则抛出 QuotaExceededError 异常并中止这些步骤。
注
例如，如果媒体元素已达到 HAVE_METADATA readyState，用户代理 MAY 抛出 QuotaExceededError 异常。如果用户代理的媒体引擎不支持在播放期间添加更多轨道，则可能会发生这种情况。
如果 readyState 属性不处于 "open" 状态，则抛出 InvalidStateError 异常并中止这些步骤。
如果此对象是一个 ManagedMediaSource，则令 buffer 为 ManagedSourceBuffer 的新实例，否则为 SourceBuffer 的新实例，并带有它们各自关联的资源。
将 buffer 的 [[生成时间戳标志]] 设置为与 type 关联的 Media Source Extensions™ 字节流格式注册表条目中“生成时间戳标志”列中的值。
如果 buffer 的 [[生成时间戳标志]] 为 true，则将 buffer 的 mode 设置为 "sequence"。否则，将 buffer 的 mode 设置为 "segments"。
将 buffer 追加到此对象的 sourceBuffers 中。
排队一个任务，在此对象的 sourceBuffers 上触发一个名为 addsourcebuffer 的事件。
返回 buffer。

从 sourceBuffers 中移除 SourceBuffer。

如果 sourceBuffer 指定的对象不在 sourceBuffers 中，则抛出 NotFoundError 异常并中止这些步骤。
如果 sourceBuffer.updating 属性等于 true，则运行以下步骤：
1. 如果正在运行，则中止缓冲区追加算法。
2. 将 sourceBuffer.updating 属性设置为 false。
3. 排队一个任务，在 sourceBuffer 上触发一个名为 abort 的事件。
4. 排队一个任务，在 sourceBuffer 上触发一个名为 updateend 的事件。
令 SourceBuffer 音频轨道列表 等于 sourceBuffer.audioTracks 返回的 AudioTrackList 对象。
如果 SourceBuffer 音频轨道列表 不为空，则运行以下步骤：
1. 对于 SourceBuffer 音频轨道列表 中的每个 AudioTrack 对象，运行以下步骤：
  1. 将 AudioTrack 对象上的 sourceBuffer 属性设置为 null。
  2. 从 SourceBuffer 音频轨道列表 中移除 AudioTrack 对象。
    注
    这应当触发 AudioTrackList [HTML] 逻辑来排队一个任务，在 SourceBuffer 音频轨道列表 上触发一个名为 removetrack 的事件，使用 TrackEvent，其 track 属性初始化为该 AudioTrack 对象。如果 AudioTrack 对象上的 enabled 属性在此移除步骤开始时为 true，则这也应当触发 AudioTrackList [HTML] 逻辑来排队一个任务，在 SourceBuffer 音频轨道列表 上触发一个名为 change 的事件。
  3. 使用必要时镜像算法在 Window 中运行以下步骤，以从媒体元素中移除 AudioTrack 对象（或者如果 MediaSource 对象是在 DedicatedWorkerGlobalScope 中构建的，则改为其 Window 镜像）。
    1. 令 HTMLMediaElement 音频轨道列表 等于 HTMLMediaElement 上 audioTracks 属性返回的 AudioTrackList 对象。
    2. 从 HTMLMediaElement 音频轨道列表 中移除该 AudioTrack 对象。
      注
      这应当触发 AudioTrackList [HTML] 逻辑来排队一个任务，在 HTMLMediaElement 音频轨道列表 上触发一个名为 removetrack 的事件，使用 TrackEvent，其 track 属性初始化为该 AudioTrack 对象。如果 AudioTrack 对象上的 enabled 属性在此移除步骤开始时为 true，则这也应当触发 AudioTrackList [HTML] 逻辑来排队一个任务，在 HTMLMediaElement 音频轨道列表 上触发一个名为 change 的事件。
令 SourceBuffer 视频轨道列表 等于 sourceBuffer.videoTracks 返回的 VideoTrackList 对象。
如果 SourceBuffer 视频轨道列表 不为空，则运行以下步骤：
1. 对于 SourceBuffer 视频轨道列表 中的每个 VideoTrack 对象，运行以下步骤：
  1. 将 VideoTrack 对象上的 sourceBuffer 属性设置为 null。
  2. 从 SourceBuffer 视频轨道列表 中移除 VideoTrack 对象。
    注
    这应当触发 VideoTrackList [HTML] 逻辑来排队一个任务，在 SourceBuffer 视频轨道列表 上触发一个名为 removetrack 的事件，使用 TrackEvent，其 track 属性初始化为该 VideoTrack 对象。如果 VideoTrack 对象上的 selected 属性在此移除步骤开始时为 true，则这也应当触发 VideoTrackList [HTML] 逻辑来排队一个任务，在 SourceBuffer 视频轨道列表 上触发一个名为 change 的事件。
  3. 使用必要时镜像算法在 Window 中运行以下步骤，以从媒体元素中移除 VideoTrack 对象（或者如果 MediaSource 对象是在 DedicatedWorkerGlobalScope 中构建的，则改为其 Window 镜像）。
    1. 令 HTMLMediaElement 视频轨道列表 等于 HTMLMediaElement 上 videoTracks 属性返回的 VideoTrackList 对象。
    2. 从 HTMLMediaElement 视频轨道列表 中移除该 VideoTrack 对象。
      注
      这应当触发 VideoTrackList [HTML] 逻辑来排队一个任务，在 HTMLMediaElement 视频轨道列表 上触发一个名为 removetrack 的事件，使用 TrackEvent，其 track 属性初始化为该 VideoTrack 对象。如果 VideoTrack 对象上的 selected 属性在此移除步骤开始时为 true，则这也应当触发 VideoTrackList [HTML] 逻辑来排队一个任务，在 HTMLMediaElement 视频轨道列表 上触发一个名为 change 的事件。
令 SourceBuffer 文本轨道列表 等于 sourceBuffer.textTracks 返回的 TextTrackList 对象。
如果 SourceBuffer 文本轨道列表 不为空，则运行以下步骤：
1. 对于 SourceBuffer 文本轨道列表 中的每个 TextTrack 对象，运行以下步骤：
  1. 将 TextTrack 对象上的 sourceBuffer 属性设置为 null。
  2. 从 SourceBuffer 文本轨道列表 中移除 TextTrack 对象。
    注
    这应触发 TextTrackList [HTML] 逻辑，以排队一个任务，在 SourceBuffer textTracks 列表 上触发一个事件，该事件名为 removetrack，使用 TrackEvent，并将 track 属性初始化为 TextTrack 对象。如果在移除步骤开始时 TextTrack 对象上的 mode 属性为 "showing" 或 "hidden"，则这还应触发 TextTrackList [HTML] 逻辑，以排队一个任务，在 SourceBuffer textTracks 列表 上触发一个事件，该事件名为 change。
  3. 使用必要时镜像 (mirror if necessary) 算法在 Window 中运行以下步骤，以从媒体元素中移除 TextTrack 对象（或者，如果 MediaSource 对象是在 DedicatedWorkerGlobalScope 中构造的，则移除其 Window 镜像）。
    1. 令 HTMLMediaElement textTracks 列表 等于 HTMLMediaElement 上 textTracks 属性返回的 TextTrackList 对象。
    2. 从 HTMLMediaElement textTracks 列表 中移除 TextTrack 对象。
      注
      这应触发 TextTrackList [HTML] 逻辑，以排队一个任务，在 HTMLMediaElement textTracks 列表 上触发一个事件，该事件名为 removetrack，使用 TrackEvent，并将 track 属性初始化为 TextTrack 对象。如果在移除步骤开始时 TextTrack 对象上的 mode 属性为 "showing" 或 "hidden"，则这还应触发 TextTrackList [HTML] 逻辑，以排队一个任务，在 HTMLMediaElement textTracks 列表 上触发一个事件，该事件名为 change。
如果 sourceBuffer 在 activeSourceBuffers 中，则从 activeSourceBuffers 中移除 sourceBuffer，并排队一个任务，在 SourceBufferList（由 activeSourceBuffers 返回）上触发一个事件，该事件名为 removesourcebuffer。
从 sourceBuffers 中移除 sourceBuffer，并排队一个任务，在 SourceBufferList（由 sourceBuffers 返回）上触发一个事件，该事件名为 removesourcebuffer。
销毁 sourceBuffer 的所有资源。

表示流的结束。

如果 readyState 属性不在 "open" 状态，则抛出一个 InvalidStateError 异常并中止这些步骤。
如果 sourceBuffers 中的任何 SourceBuffer 上的 updating 属性等于 true，则抛出一个 InvalidStateError 异常并中止这些步骤。
运行流结束 (end of stream) 算法，并将 error 参数设置为 error。

更新用于第 10. HTMLMediaElement 扩展章节的 [[live seekable range]]，以修改 HTMLMediaElement 的 seekable 行为。

调用此方法时，用户代理必须执行以下步骤

如果 readyState 属性不是 "open"，则抛出一个 InvalidStateError 异常并中止这些步骤。
如果 start 为负数或大于 end，则抛出一个 TypeError 异常并中止这些步骤。
将 [[live seekable range]] 设置为一个新的归一化 TimeRanges 对象，其中包含一个单一范围，其开始位置为 start，结束位置为 end。

更新用于第 10. HTMLMediaElement 扩展章节的 [[live seekable range]]，以修改 HTMLMediaElement 的 seekable 行为。

调用此方法时，用户代理必须执行以下步骤

如果 readyState 属性不是 "open"，则抛出一个 InvalidStateError 异常并中止这些步骤。
如果 [[live seekable range]] 包含一个范围，则将 [[live seekable range]] 设置为一个新的空 TimeRanges 对象。

检查 MediaSource 是否能够为指定的 MIME 类型创建 SourceBuffer 对象。

注

如果此方法返回 true，则仅表示 MediaSource 实现有能力为指定的 MIME 类型创建 SourceBuffer 对象。如果可用资源不足以支持添加新的 SourceBuffer，addSourceBuffer() 调用仍应失败。

注

此方法返回 true 暗示 HTMLMediaElement 的 canPlayType() 将返回 "maybe" 或 "probably"，因为 MediaSource 支持 HTMLMediaElement 已知无法播放的类型是没有意义的。

调用此方法时，用户代理必须执行以下步骤

如果 type 为空字符串，则返回 false。
如果 type 不包含有效的 MIME 类型字符串，则返回 false。
如果 type 包含 MediaSource 不支持的媒体类型或媒体子类型，则返回 false。
如果 type 包含 MediaSource 不支持的编解码器，则返回 false。
如果 MediaSource 不支持指定的媒体类型、媒体子类型和编解码器的组合，则返回 false。
返回 true。

事件名称	Interface	调度时间：当……时
sourceopen	`Event`	`MediaSource` 的 `readyState` 从 "`closed`" 转换为 "`open`"，或从 "`ended`" 转换为 "`open`"。
sourceended	`Event`	`MediaSource` 的 `readyState` 从 "`open`" 转换为 "`ended`"。
sourceclose	`Event`	`MediaSource` 的 `readyState` 从 "`open`" 转换为 "`closed`"，或从 "`ended`" 转换为 "`closed`"。

当 Window HTMLMediaElement 附加到 DedicatedWorkerGlobalScope MediaSource 时，每个上下文都有依赖于对方信息的算法。

注

HTMLMediaElement 仅向 Window 上下文公开，但本规范中定义的 MediaSource 及相关对象在 Window 和 DedicatedWorkerGlobalScope 上下文中均被公开。这允许应用程序在上述任一上下文中构造 MediaSource 对象，并使用 MediaSource 对象 URL 或 MediaSourceHandle（如附加到媒体元素算法中所述）将其附加到 Window 上下文中的 HTMLMediaElement 对象。 MediaSource 对象不是 Transferable 的；它仅在创建它的上下文中可见。

本节的其余部分描述了一个用于限制 Window 媒体元素与 DedicatedWorkerGlobalScope MediaSource 附件之间的信息延迟的模型。虽然该模型描述了使用消息传递进行通信，但实现可以选择以可能更快的方式（例如使用共享内存和锁）进行通信。附加到 Window MediaSource 的附件无需跨上下文通信即可同步拥有信息。

在 DedicatedWorkerGlobalScope 中构造的 MediaSource 具有一个 [[port to main]] 内部槽位，该槽位在附加期间存储一个 MessagePort，并在分离时将其置空。 Window 的 [[port to main]] 始终为 null。

由本规范扩展并附加到 DedicatedWorkerGlobalScope MediaSource 的 HTMLMediaElement 类似地具有一个 [[port to worker]] 内部槽位，该槽位存储一个 MessagePort，以及一个 [[channel with worker]] 内部槽位，该槽位存储一个 MessageChannel，两者均在附加期间设置，并在分离时置空。除非附加到 DedicatedWorkerGlobalScope MediaSource，否则 [[port to worker]] 和 [[channel with worker]] 均为 null。

本规范中需要将信息从 Window HTMLMediaElement 通信到附加的 DedicatedWorkerGlobalScope MediaSource 的算法（反之亦然）将隐式使用这些内部端口向对应方发布消息，消息的隐式处理程序将运行算法中所述的步骤。

根据 MediaSource 对象是在 Window 还是在 DedicatedWorkerGlobalScope 中构造，将 MediaSource 附加到媒体元素有不同的机制。

将构造于 Window 中的 MediaSource 附加到媒体元素，可以通过将该 MediaSource 的 MediaSource 对象 URL 分配给媒体元素的 src 属性或媒体元素内 <source> 的 src 属性来完成。 MediaSource 对象 URL 是通过将 MediaSource 对象传递给 createObjectURL() 来创建的。

尽管实现可能允许在 DedicatedWorkerGlobalScope 中为该 Worker 中构造的 MediaSource 创建 MediaSource 对象 URL，但尝试通过 src 属性或媒体元素内 <source> 的 src 属性，使用该 MediaSource 对象 URL 附加到媒体元素，必须在媒体元素的资源获取算法（如下扩展）中失败。

注
将对象 URL 附加机制扩展到 Worker MediaSource 对象 URL 将进一步推广这种相比于使用 srcObject 而言不太受欢迎的习惯用法，并将不必要地增加用户代理的互操作性风险和实现复杂度。
将构造于 DedicatedWorkerGlobalScope 中的 MediaSource 附加到媒体元素，只能通过使用 handle 从中获取句柄，将该 MediaSourceHandle 传输到 Window 上下文，并将其分配给媒体元素的 srcObject 属性来完成。为了使本规范与 HTMLMediaElement 资源加载和获取算法保持一致，底层的 DedicatedWorkerGlobalScope MediaSource 是此处提到的 MediaSource 对象，而 MediaSourceHandle 对象是媒体提供者对象。

如果资源获取算法是使用 MediaSource 对象、MediaSourceHandle 对象或对象为 MediaSource 对象的 URL 记录调用的，则令 mode 为 local，跳过资源获取算法中的第一步（该步骤可能会将 mode 设置为 remote），并继续执行资源获取算法。

注

资源获取算法的第一步预期最终将与为对象是媒体提供者对象的 URL 记录选择 local 模式保持一致。其目的是，如果 HTMLMediaElement 的 src 属性或选定的子 source 的 src 属性在各自的 src 属性上次更改时，是一个匹配 MediaSource 对象 URL 的 blob: URL，则该 MediaSource 对象即被用作资源获取算法中 local 模式逻辑下的媒体提供者对象和当前媒体资源。这也意味着当附加了 MediaSource 对象时，包含对任何 preload 属性观察的 remote 模式逻辑将被跳过。即使在对 [HTML] 进行了最终更改之后，当当前媒体资源是 MediaSource 对象时，仍需要在 local 模式逻辑的开头执行以下步骤。

在资源获取算法的“否则 (mode 为 local)”部分的开头，执行下述附加步骤。

注

相对于触发媒体元素资源选择算法的操作而言，这些步骤是异步的。在允许调用资源选择算法的任务继续并达到稳定状态后，运行资源获取算法。实现可以延迟下述“Otherwise”子句中的步骤，直到 MediaSource 对象准备好使用为止。

如果资源获取算法是使用 MediaSource 对象、MediaSourceHandle 对象或对象为 MediaSource 对象的 URL 记录调用的，则
如果媒体提供者对象是一个 URL 记录，其对象是构造于 DedicatedWorkerGlobalScope 中的 MediaSource，例如试图使用来自 DedicatedWorkerGlobalScope MediaSource 的 MediaSource 对象 URL 时发生的情况

运行资源获取算法的媒体数据处理步骤列表中的 “如果由于网络错误而根本无法获取媒体数据，导致用户代理放弃尝试获取资源” 步骤。
注
这可以防止将 MediaSource 对象 URL 用于 DedicatedWorker MediaSource 附件。将 MediaSource 的 handle 从 DedicatedWorker 传输到 Window 上下文并将其分配给媒体元素的 srcObject 属性，是附加此类 MediaSource 的唯一方法。

如果媒体提供者对象是一个 MediaSourceHandle，且其 [[Detached]] 内部槽位为 true

运行资源获取算法的媒体数据处理步骤列表中的 “如果由于网络错误而根本无法获取媒体数据，导致用户代理放弃尝试获取资源” 步骤。

如果媒体提供者对象是一个 MediaSourceHandle，且其底层 MediaSource 的 [[has ever been attached]] 内部槽位为 true

运行资源获取算法的媒体数据处理步骤列表中的 “如果由于网络错误而根本无法获取媒体数据，导致用户代理放弃尝试获取资源” 步骤。
注
这可以防止使用 MediaSourceHandle 多次加载底层的 MediaSource，即使该 MediaSource 是在 Window 上构造的，并且之前已使用 MediaSource 对象 URL 加载过。但这并不妨碍后续成功使用 Window MediaSource 的 MediaSource 对象 URL。

如果 readyState 未设置为 "closed"

运行资源获取算法的媒体数据处理步骤列表中的 “如果由于网络错误而根本无法获取媒体数据，导致用户代理放弃尝试获取资源” 步骤。

否则
1. 将 MediaSource 的 [[has ever been attached]] 内部槽位设置为 true。
2. 将媒体元素的 delaying-the-load-event-flag 设置为 false。
3. 如果 MediaSource 是在 DedicatedWorkerGlobalScope 中构造的，则设置 Worker 附件通信并打开 MediaSource
  
  将 [[channel with worker]] 设置为一个新的 MessageChannel。
  
  将 [[port to worker]] 设置为 [[channel with worker]] 的 port1 值。
  
  执行 StructuredSerializeWithTransfer，并将 [[channel with worker]] 的 port2 作为值和 transferList 的唯一成员，令结果为 serialized port2。
  
  排队一个任务在 MediaSource 的 DedicatedWorkerGlobalScope 上，该任务将
  
  执行 StructuredDeserializeWithTransfer，使用 serialized port2 和 DedicatedWorkerGlobalScope 的领域 (realm)，并将 [[port to main]] 设置为传输后的 [[channel with worker]] 的 port2 值的反序列化克隆。
  
  将 readyState 属性设置为 "open"。
  
  排队一个任务，在 MediaSource 上触发一个事件，该事件名为 sourceopen。
  
  否则，MediaSource 是在 Window 中构造的
  
  将 [[channel with worker]] 设置为 null。
  
  将 [[port to worker]] 设置为 null。
  
  将 [[port to main]] 设置为 null。
  
  将 readyState 属性设置为 "open"。
  
  排队一个任务，在 MediaSource 上触发一个事件，该事件名为 sourceopen。
4. 通过运行剩余的 “Otherwise (mode is local)” 步骤继续执行资源获取算法，并满足以下要求
  1. 资源获取算法或媒体数据处理步骤列表中提及“下载”、“已接收字节”或“每当当前媒体资源有新数据可用时”的文本，是指通过 appendBuffer() 传入的数据。
  2. 资源获取算法和媒体数据处理步骤列表中对 HTTP 的引用不适用，因为当附加了 MediaSource 时，HTMLMediaElement 不通过 HTTP 获取媒体数据。

注

附加的 MediaSource 不使用资源获取算法中的 remote 模式步骤，因此媒体元素不会触发 "suspend" 事件。虽然本规范的未来版本可能会从附加了 MediaSource 的媒体元素中删除 "progress" 和 "stalled" 事件，但符合本版规范的用户代理仍可能触发这两个事件，因为这些 [HTML] 引用在本规范实现稳定后发生了变化。

在任何媒体元素将要转换为 NETWORK_EMPTY 并排队一个任务在媒体元素上触发一个事件（名为 emptied）的情况下，均运行以下步骤。这些步骤应在转换之前立即运行。

如果 MediaSource 是在 DedicatedWorkerGlobalScope 中构造的
1. 使用发布到 [[port to worker]] 的内部 detach 消息通知 MediaSource。
2. 将 [[port to worker]] 设置为 null。
3. 将 [[channel with worker]] 设置为 null。
4. 此 detach 通知的隐式消息处理程序在 DedicatedWorkerGlobalScope MediaSource 中运行这些步骤的其余部分。
否则，MediaSource 是在 Window 中构造的

在 Window MediaSource 上继续运行这些步骤的其余部分。
将 [[port to main]] 设置为 null。
将 readyState 属性设置为 "closed"。
如果 this 是 ManagedMediaSource，则将 streaming 属性设置为 false。
将 duration 更新为 NaN。
从 activeSourceBuffers 中移除所有 SourceBuffer 对象。
排队一个任务，在 activeSourceBuffers 上触发一个事件，该事件名为 removesourcebuffer。
从 sourceBuffers 中移除所有 SourceBuffer 对象。
排队一个任务，在 sourceBuffers 上触发一个事件，该事件名为 removesourcebuffer。
排队一个任务，在 MediaSource 上触发一个事件，该事件名为 sourceclose。

注

今后，此算法旨在被外部调用，并在任何需要将附加的 MediaSource（如有）从媒体元素分离的情况下运行。除了或替代媒体元素转换为 NETWORK_EMPTY 的情况外，它可以在 HTMLMediaElement [HTML] 操作（如 load()）和资源获取算法失败时调用。资源获取算法失败是指那些中止资源获取算法或资源选择算法的失败，但“最终步骤” [HTML] 不被视为触发分离的失败。

作为搜寻算法 (seek algorithm) 的“等待直到用户代理确定新播放位置的媒体数据是否可用，如果可用，则等待直到它解码出足够的数据来播放该位置”步骤的一部分，运行以下步骤

注
媒体元素在 activeSourceBuffers 中的每个 SourceBuffer 对象中查找包含 新播放位置 的媒体段 (media segments)。 HTMLMediaElement 的 buffered 属性当前值中 TimeRanges 内的任何位置都已缓存了该位置所需的所有媒体段。
如果 新播放位置 不在 HTMLMediaElement 的 buffered 的任何 TimeRanges 中
1. 如果 HTMLMediaElement 的 readyState 属性大于 HAVE_METADATA，则将 HTMLMediaElement 的 readyState 属性设置为 HAVE_METADATA。
  注
  根据 HTMLMediaElement 就绪状态 (ready states) [HTML] 逻辑，HTMLMediaElement 的 readyState 更改可能会触发 HTMLMediaElement 上的事件。
2. 媒体元素等待直到 appendBuffer() 调用导致编码帧处理 (coded frame processing) 算法将 HTMLMediaElement 的 readyState 属性设置为大于 HAVE_METADATA 的值。
  注
  Web 应用程序可以使用 buffered 和 HTMLMediaElement 的 buffered 来确定媒体元素需要什么来恢复播放。
否则

继续
注
如果 readyState 属性为 "ended"，且 新播放位置 在 HTMLMediaElement 的 buffered 中的某个 TimeRanges 内，则搜寻操作必须在此处继续完成，即使一个或多个当前选定或启用的轨道缓冲区的最大范围结束时间戳小于 新播放位置。这种情况应该仅由于 buffered 中的逻辑而在 readyState 为 "ended" 时发生。
媒体元素重置所有解码器，并使用来自适当初始化段 (initialization segment) 的数据初始化每个解码器。
媒体元素将来自活跃轨道缓冲区 (active track buffers) 的编码帧 (coded frames) 输入解码器，起始于 新播放位置 之前的最近的随机访问点 (random access point)。
在“Await a stable state”步骤处恢复搜寻算法。

在播放期间定期运行以下步骤，以确保 activeSourceBuffers 中的所有 SourceBuffer 对象都有确保不中断播放的足够数据 (enough data to ensure uninterrupted playback)。对 activeSourceBuffers 的更改也会导致这些步骤运行，因为它们会影响触发状态转换的条件。

拥有确保不中断播放的足够数据是一个特定于实现的条件，用户代理在该条件下确定它当前有足够的数据来播放演示文稿，而不会在有意义的时间段内停顿。该条件不断被评估，以确定何时将媒体元素切换进出 HAVE_ENOUGH_DATA 就绪状态。这些转换分别表示用户代理认为它已缓存足够的数据，或者需要更多数据。

注

实现可以选择使用缓存字节数、缓存时间、追加速率或任何其他其认为合适的指标来确定何时拥有足够的数据。所使用的指标在播放期间可能会发生变化，因此 Web 应用程序应仅依赖 HTMLMediaElement 的 readyState 的值来确定是否需要更多数据。

注

当媒体元素需要更多数据时，用户代理应在足够早的时间将其从 HAVE_ENOUGH_DATA 切换到 HAVE_FUTURE_DATA，以便 Web 应用程序能够做出响应而不会导致播放中断。例如，当当前播放位置在缓存数据结束前 500ms 时进行切换，给应用程序大约 500ms 的时间来在播放停顿前追加更多数据。

如果 HTMLMediaElement 的 readyState 属性等于 HAVE_NOTHING

中止这些步骤。

如果 HTMLMediaElement 的 buffered 不包含针对当前播放位置的 TimeRanges

将 HTMLMediaElement 的 readyState 属性设置为 HAVE_METADATA。
注
根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 更改可能会触发 HTMLMediaElement 上的事件。
中止这些步骤。

如果 HTMLMediaElement 的 buffered 包含一个包含当前播放位置的 TimeRanges 并且有确保不中断播放的足够数据

将 HTMLMediaElement 的 readyState 属性设置为 HAVE_ENOUGH_DATA。
注
根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 更改可能会触发 HTMLMediaElement 上的事件。
如果播放之前因转换为 HAVE_CURRENT_DATA 而被暂停，则播放可能会在此处恢复。
中止这些步骤。

如果 HTMLMediaElement 的 buffered 包含一个包含当前播放位置以及当前播放位置之后一段时间的 TimeRanges，则运行以下步骤

将 HTMLMediaElement 的 readyState 属性设置为 HAVE_FUTURE_DATA。
注
根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 更改可能会触发 HTMLMediaElement 上的事件。
如果播放之前因转换为 HAVE_CURRENT_DATA 而被暂停，则播放可能会在此处恢复。
中止这些步骤。

如果 HTMLMediaElement 的 buffered 包含一个在当前播放位置结束且没有覆盖当前位置之后紧接时间的范围的 TimeRanges

将 HTMLMediaElement 的 readyState 属性设置为 HAVE_CURRENT_DATA。
注
根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 更改可能会触发 HTMLMediaElement 上的事件。
播放此时被暂停，因为媒体元素没有足够的数据来推进媒体时间线 (media timeline)。
中止这些步骤。

在播放期间，如果 selected 视频轨道、enabled 音频轨道或文本轨道 mode 发生变化，则需要更新 activeSourceBuffers。当这些更改中的一个或多个发生时，需要遵循以下步骤。此外，当 MediaSource 是在 DedicatedWorkerGlobalScope 中构造时，对先前由内部 create track mirror 消息的隐式处理程序创建的轨道的 Window 镜像所发生的每次更改，必须通过发布到 [[port to worker]] 的内部 update track state 消息（其隐式处理程序进行更改并运行以下步骤）同样应用到相应的 DedicatedWorkerGlobalScope 轨道。同样，对 DedicatedWorkerGlobalScope 轨道发生的每次更改，必须通过发布到 [[port to main]] 的内部 update track state 消息（其隐式处理程序对镜像进行更改）同样应用到相应的轨道 Window 镜像。

如果选定的视频轨道发生变化，则运行以下步骤

如果与先前选定的视频轨道关联的 SourceBuffer 未与任何其他已启用的轨道关联，则运行以下步骤
1. 从 activeSourceBuffers 中移除 SourceBuffer。
2. 排队一个任务，在 activeSourceBuffers 上触发一个事件，该事件名为 removesourcebuffer
如果与新选定的视频轨道关联的 SourceBuffer 尚未在 activeSourceBuffers 中，则运行以下步骤
1. 将 SourceBuffer 添加到 activeSourceBuffers。
2. 排队一个任务，在 activeSourceBuffers 上触发一个事件，该事件名为 addsourcebuffer

如果音频轨道被禁用，且与此轨道关联的 SourceBuffer 未与任何其他已启用或选定的轨道关联，则运行以下步骤

从 activeSourceBuffers 中移除与音频轨道关联的 SourceBuffer
排队一个任务，在 activeSourceBuffers 上触发一个事件，该事件名为 removesourcebuffer

如果音频轨道被启用，且与此轨道关联的 SourceBuffer 尚未在 activeSourceBuffers 中，则运行以下步骤

将与音频轨道关联的 SourceBuffer 添加到 activeSourceBuffers
排队一个任务，在 activeSourceBuffers 上触发一个事件，该事件名为 addsourcebuffer

如果文本轨道的 mode 变为 "disabled"，且与此轨道关联的 SourceBuffer 未与任何其他已启用或选定的轨道关联，则运行以下步骤

从 activeSourceBuffers 中移除与文本轨道关联的 SourceBuffer
排队一个任务，以在 activeSourceBuffers 上触发一个名为 removesourcebuffer 的事件。

如果某个文本轨道的 mode 变为 "showing" 或 "hidden"，且与该轨道关联的 SourceBuffer 尚未处于 activeSourceBuffers 中，则执行以下步骤

将与该文本轨道关联的 SourceBuffer 添加到 activeSourceBuffers 中
排队一个任务，以在 activeSourceBuffers 上触发一个名为 addsourcebuffer 的事件。

当 duration 需要变更为新时长时，执行这些步骤。

如果 duration 的当前值等于新时长，则返回。
如果新时长小于 sourceBuffers 中任何 SourceBuffer 对象的所有已缓冲编码帧的最高呈现时间戳，则抛出 InvalidStateError 异常并终止这些步骤。
注
不允许会导致截断当前已缓冲媒体的时长缩减。当需要截断时，请在更新 duration 之前，使用 remove() 来减小缓冲范围。
令 最高结束时间 为 sourceBuffers 中所有 SourceBuffer 对象中，所有轨道缓冲区的轨道缓冲区范围结束时间中的最大值。
如果新时长小于最高结束时间，则
注
这种情况的发生是因为编码帧移除算法会保留在移除范围开始之前开始的编码帧。
1. 将新时长更新为等于最高结束时间。
将 duration 更新为新时长。
使用必要时镜像 (mirror if necessary) 算法，在 Window 中执行以下步骤以更新媒体元素的时长
1. 将媒体元素的 duration 更新为新时长。
2. 运行 HTMLMediaElement 时长变更算法。

当应用程序通过 endOfStream() 调用发出流结束信号，或者某个算法需要发出解码错误信号时，会调用此算法。此算法接收一个 error 参数，用于指示是否将发出错误信号。

将 readyState 属性值更改为 "ended"。
排队一个任务，以在 MediaSource 上触发一个名为 sourceended 的事件。
如果未设置 error
1. 运行时长变更算法，并将新时长设置为 sourceBuffers 中所有 SourceBuffer 对象中，所有轨道缓冲区的轨道缓冲区范围结束时间中的最大值。
  注
  这允许时长准确反映所添加媒体片段的结尾。例如，如果时长明确设置为 10 秒，但在调用 endOfStream() 之前仅添加了 0 到 5 秒的媒体片段，则时长将更新为 5 秒。
2. 通知媒体元素它现在拥有所有媒体数据。
如果 error 设置为 "network"

使用必要时镜像算法在 Window 中执行以下步骤

如果 HTMLMediaElement 的 readyState 属性等于 HAVE_NOTHING

运行资源获取算法的媒体数据处理步骤列表中的 “如果由于网络错误而根本无法获取媒体数据，导致用户代理放弃尝试获取资源” 步骤。

如果 HTMLMediaElement 的 readyState 属性大于 HAVE_NOTHING

运行资源获取算法的媒体数据处理步骤列表中，“如果连接在接收到部分媒体数据后中断，导致用户代理放弃获取资源的尝试”的步骤。

如果 error 设置为 "decode"
使用必要时镜像算法在 Window 中执行以下步骤

如果 HTMLMediaElement 的 readyState 属性等于 HAVE_NOTHING
运行资源获取算法的媒体数据处理步骤列表中，“如果媒体数据可以获取，但经检查发现格式不受支持，或完全无法渲染”的步骤。
如果 HTMLMediaElement 的 readyState 属性大于 HAVE_NOTHING

运行资源获取算法的媒体数据处理步骤列表中，“媒体数据已损坏”的步骤。

此算法用于从附加在相同 Window 或 DedicatedWorkerGlobalScope 上的 MediaSource，在 Window 上执行步骤，通常用于更新所附加的 HTMLMediaElement 的状态。此算法接收一个 steps 参数，列出了要在 Window 上运行的步骤。

如果 MediaSource 是在 DedicatedWorkerGlobalScope 中构造的

向 [[port to main]] 发送一个内部的 mirror on window 消息，其在 Window 中的隐式处理程序将运行 steps。在不等待该处理程序接收消息的情况下将控制权返回给调用者。

注

镜像消息机制的目的是确保

steps 作为其自身的任务在 Window 上异步运行，而不是在其他 Window 任务执行过程中中断运行，并且
运行 steps 时不会阻塞此算法在 DedicatedWorkerGlobalScope 上的同步执行和返回。

否则

运行 steps。

MediaSourceHandle 接口表示 MediaSource 对象的代理，它可用于将 DedicatedWorkerGlobalScope 中的 MediaSource，通过使用 srcObject（如附加到媒体元素算法中所述），附加到 Window 的 HTMLMediaElement 上。

注

这种独特的对象对于将跨上下文的 MediaSource 附加到媒体元素是必要的，因为 MediaSource 对象本身是事件目标，不可传输。

每个 MediaSourceHandle 对象都有一个 [[has ever been assigned as srcobject]] 内部槽，用于存储一个 boolean 值。它在 MediaSourceHandle 对象创建时初始化为 false，在扩展的 HTMLMediaElement 的 srcObject 设置器中（如10. HTMLMediaElement 扩展章节所述）被设置为 true。如果为 true，则会阻止该 MediaSourceHandle 成功进行传输（如4.1 传输章节所述）。

MediaSourceHandle 对象是 Transferable 的，每个对象都有一个 [[Detached]] 内部槽，用于确保一旦句柄对象实例被传输，该实例就不能再次被传输。

WebIDL[Transferable, Exposed=(Window,DedicatedWorker)]
interface MediaSourceHandle {};

MediaSourceHandle 的传输步骤和传输接收步骤要求实现维护一个隐式内部槽，引用底层的 MediaSource，以启用使用 srcObject 的附加到媒体元素操作，并随后设置附件的跨上下文通信模型。

注

实现者应注意，Transferable 所暗示的“移动”语义并不总是事实。例如，使用广播的 postMessage 的扩展或内部实现可能会导致传输后的 MediaSourceHandle 出现非预期的多个接收者。因此，建议实现不要解析传输后的 MediaSourceHandle 的哪个潜在克隆仍然有效，直到且仅当底层 MediaSource 对象的任何句柄在媒体元素的资源选择算法的异步部分中使用时。这类似于通过 MediaSource 对象 URL 进行附加的现有行为，该 URL 可以轻松克隆，但此类 URL 最多仅对一个附加操作（在其所有潜在的众多克隆中）有效。

实现必须支持每个 MediaSourceHandle 底层的 MediaSource 对象，通过 srcObject 进行最多一次的附件（加载），无论由于 Transferable 的不同实现导致 MediaSourceHandle 潜在的克隆如何。

注

参见附加到媒体元素，了解如何在媒体元素资源选择算法的异步部分中强制执行此操作。

MediaSourceHandle 仅在 Window 和 DedicatedWorkerGlobalScope 上下文中公开，无法在不同的代理集群之间成功传输 [ECMASCRIPT]。MediaSourceHandle 对象的传输仅能在同一个代理集群内成功。

注

例如，将 MediaSourceHandle 对象从 Window 或 DedicatedWorkerGlobalScope 传输到 SharedWorker 或 ServiceWorker 将不会成功。开发者应注意这种与 MediaSource 对象 URL 的区别，后者是可以通过多种方式通信的 DOMString。即便如此，使用 MediaSource 对象 URL 进行附加到媒体元素的操作，也只能对于在 Window 上下文中构造的 MediaSource 成功。另请参见 Web 应用程序 API 的代理和代理集群形式集成的定义 [HTML]，其中定义了诸如专用工作线程代理等相关概念。

MediaSourceHandle 对象的传输步骤必须包含以下步骤

如果 MediaSourceHandle 的 [[has ever been assigned as srcobject]] 内部槽为 true，则传输步骤必须通过抛出 DataCloneError 异常而失败。

WebIDLenum AppendMode {
  "segments",
  "sequence",
};

片段 (segments): 媒体片段中的时间戳决定了编码帧在呈现中的位置。媒体片段可以以任意顺序添加。
sequence: 无论媒体片段中的时间戳如何，媒体片段在时间上都将被视为相邻。新媒体片段中的编码帧将被放置在前一个媒体片段中的编码帧之后。timestampOffset 属性将在需要新偏移量以使新媒体片段与前一个媒体片段相邻时进行更新。在 "sequence" 模式下设置 timestampOffset 属性，允许在不知道媒体片段中时间戳的情况下，将媒体片段放置在时间轴上的特定位置。

WebIDL[Exposed=(Window,DedicatedWorker)]
interface SourceBuffer : EventTarget {
  attribute AppendMode mode;
  readonly  attribute boolean updating;
  readonly  attribute TimeRanges buffered;
  attribute double timestampOffset;
  readonly  attribute AudioTrackList audioTracks;
  readonly  attribute VideoTrackList videoTracks;
  readonly  attribute TextTrackList textTracks;
  attribute double appendWindowStart;
  attribute unrestricted double appendWindowEnd;

  attribute EventHandler onupdatestart;
  attribute EventHandler onupdate;
  attribute EventHandler onupdateend;
  attribute EventHandler onerror;
  attribute EventHandler onabort;

  undefined appendBuffer(BufferSource data);
  undefined abort();
  undefined changeType(DOMString type);
  undefined remove(double start, unrestricted double end);
};

Issue 280: MSE-in-Workers: {Audio,Video,Text}Track{,List} IDL in HTML need additional DedicatedWorker in Exposed mse-in-workers

[HTML] AudioTrackList, VideoTrackList 和 TextTrackList 需要 Window+DedicatedWorker 公开。

mode，类型为 AppendMode

控制如何处理媒体片段序列。此属性最初由 addSourceBuffer() 在对象创建后设置，并可通过 changeType() 或设置此属性来更新。

获取时，返回初始值或最后成功设置的值。

设置时，执行以下步骤：

如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性等于 true，则抛出 InvalidStateError 异常并终止这些步骤。
令 新模式 等于正在分配给此属性的新值。
如果 [[generate timestamps flag]] 等于 true 且 新模式 等于 "segments"，则抛出 TypeError 异常并终止这些步骤。
如果父级媒体源的 readyState 属性处于 "ended" 状态，则运行以下步骤
1. 将父级媒体源的 readyState 属性设置为 "open"
2. 排队一个任务，以在父级媒体源上触发一个名为 sourceopen 的事件。
如果 [[append state]] 等于 PARSING_MEDIA_SEGMENT，则抛出 InvalidStateError 并终止这些步骤。
如果 新模式 等于 "sequence"，则将 [[group start timestamp]] 设置为 [[group end timestamp]]。
将该属性更新为新模式。

updating，类型为 boolean，只读

指示 appendBuffer() 或 remove() 操作的异步延续是否仍在处理中。对象创建时，此属性最初设置为 false。

buffered，类型为 TimeRanges，只读

指示 SourceBuffer 中缓冲了哪些 TimeRanges。对象创建时，此属性最初设置为一个空的 TimeRanges 对象。

读取该属性时，必须发生以下步骤

如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
令 最高结束时间 为此 SourceBuffer 对象管理的所有轨道缓冲区的轨道缓冲区范围结束时间中的最大值。
令 交集范围 等于一个包含从 0 到最高结束时间的单一范围的 TimeRanges 对象。
对于此 SourceBuffer 管理的每个音频和视频轨道缓冲区，执行以下步骤
注
文本轨道缓冲区包含在上面计算最高结束时间的过程中，但此处排除了缓冲范围计算。它们不一定是连续的，且其中任何不连续性也不应在其他媒体轨道在同一时间范围内连续时触发播放停顿。
1. 令 轨道范围 等于当前轨道缓冲区的轨道缓冲区范围。
2. 如果 readyState 为 "ended"，则将 轨道范围 中最后一个范围的结束时间设置为最高结束时间。
3. 令 新交集范围 等于 交集范围 与 轨道范围 之间的交集。
4. 用新交集范围替换 交集范围 中的范围。
如果 交集范围 不包含与此属性当前值完全相同的范围信息，则将此属性的当前值更新为 交集范围。
返回此属性的当前值。

timestampOffset，类型为 double

控制应用于后续媒体片段中的时间戳的偏移量，这些媒体片段会被添加（append）到此 SourceBuffer 中。timestampOffset 最初设置为 0，表示没有应用偏移量。

获取时，返回初始值或最后成功设置的值。

设置时，执行以下步骤：

令 新时间戳偏移量 等于正在分配给此属性的新值。
如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性等于 true，则抛出 InvalidStateError 异常并终止这些步骤。
如果父级媒体源的 readyState 属性处于 "ended" 状态，则运行以下步骤
1. 将父级媒体源的 readyState 属性设置为 "open"
2. 排队一个任务，以在父级媒体源上触发一个名为 sourceopen 的事件。
如果 [[append state]] 等于 PARSING_MEDIA_SEGMENT，则抛出 InvalidStateError 并终止这些步骤。
如果 mode 属性等于 "sequence"，则将 [[group start timestamp]] 设置为新时间戳偏移量。
将该属性更新为新时间戳偏移量。

audioTracks，类型为 AudioTrackList，只读

由此对象创建的 AudioTrack 对象列表。

videoTracks，类型为 VideoTrackList，只读

由此对象创建的 VideoTrack 对象列表。

textTracks，类型为 TextTrackList，只读

由此对象创建的 TextTrack 对象列表。

appendWindowStart，类型为 double

附加窗口开始处的呈现时间戳。此属性最初设置为呈现开始时间。

获取时，返回初始值或最后成功设置的值。

设置时，执行以下步骤：

如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性等于 true，则抛出 InvalidStateError 异常并终止这些步骤。
如果新值小于 0 或大于等于 appendWindowEnd，则抛出 TypeError 异常并终止这些步骤。
将该属性更新为新值。

appendWindowEnd，类型为 unrestricted double

附加窗口结束处的呈现时间戳。此属性最初设置为正无穷大 (Infinity)。

获取时，返回初始值或最后成功设置的值。

设置时，执行以下步骤：

如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性等于 true，则抛出 InvalidStateError 异常并终止这些步骤。
如果新值等于 NaN，则抛出 TypeError 并终止这些步骤。
如果新值小于等于 appendWindowStart，则抛出 TypeError 异常并终止这些步骤。
将该属性更新为新值。

onupdatestart，类型为 EventHandler

updatestart 事件的事件处理程序。

onupdate，类型为 EventHandler

update 事件的事件处理程序。

onupdateend，类型为 EventHandler

updateend 事件的事件处理程序。

onerror，类型为 EventHandler

error 事件的事件处理程序。

onabort，类型为 EventHandler

abort 事件的事件处理程序。

appendBuffer

将 BufferSource [WEBIDL] 中的片段数据添加到 SourceBuffer。

调用此方法时，用户代理必须执行以下步骤

运行准备添加 (prepare append) 算法。
将 数据 添加到 [[input buffer]] 的末尾。
将 updating 属性设置为 true。
排队一个任务，以在此 SourceBuffer 对象上触发一个名为 updatestart 的事件。
异步运行缓冲区添加 (buffer append) 算法。

abort (中止)

中止当前片段并重置片段解析器。

调用此方法时，用户代理必须执行以下步骤

如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果父级媒体源的 readyState 属性不处于 "open" 状态，则抛出 InvalidStateError 异常并终止这些步骤。
如果范围移除 (range removal) 算法正在运行，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性等于 true，则运行以下步骤
1. 如果缓冲区添加算法正在运行，则中止该算法。
2. 将 updating 属性设置为 false。
3. 排队一个任务，以在此 SourceBuffer 对象上触发一个名为 abort 的事件。
4. 排队一个任务，以在此 SourceBuffer 对象上触发一个名为 updateend 的事件。
运行重置解析器状态 (reset parser state) 算法。
将 appendWindowStart 设置为呈现开始时间。
将 appendWindowEnd 设置为正无穷大。

changeType

更改与此对象关联的 MIME 类型。随后的 appendBuffer() 调用将期望新添加的字节符合新类型。

调用此方法时，用户代理必须执行以下步骤

如果 type 是一个空字符串，则抛出 TypeError 异常并中止这些步骤。
如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性等于 true，则抛出 InvalidStateError 异常并终止这些步骤。
如果 type 包含不受支持的 MIME 类型，或包含与父级媒体源的 sourceBuffers 属性中 SourceBuffer 对象指定的（当前或之前）类型不兼容的 MIME 类型，则抛出 NotSupportedError 异常并终止这些步骤。
如果父级媒体源的 readyState 属性处于 "ended" 状态，则运行以下步骤
1. 将父级媒体源的 readyState 属性设置为 "open"。
2. 排队一个任务，以在父级媒体源上触发一个名为 sourceopen 的事件。
运行重置解析器状态算法。
将此 SourceBuffer 对象上的 [[generate timestamps flag]] 更新为与 type 相关联的字节流格式注册表 [MSE-REGISTRY] 条目中，“生成时间戳标志”列中的值。
如果 [[generate timestamps flag]] 等于 true
将此 SourceBuffer 对象上的 mode 属性设置为 "sequence"，包括运行该属性设置的相关联步骤。
否则

保持此 SourceBuffer 对象上的 mode 属性的先前值，而不运行该属性设置的任何相关联步骤。
将此 SourceBuffer 对象上的 [[pending initialization segment for changeType flag]] 设置为 true。

remove

移除特定时间范围内的媒体。移除范围的 start（以秒为单位，从呈现开始时间测量）。移除范围的 end（以秒为单位，从呈现开始时间测量）。

调用此方法时，用户代理必须执行以下步骤

如果此对象已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性等于 true，则抛出 InvalidStateError 异常并终止这些步骤。
如果 duration 等于 NaN，则抛出 TypeError 异常并终止这些步骤。
如果 start 为负数或大于 duration，则抛出 TypeError 异常并终止这些步骤。
如果 end 小于等于 start 或 end 等于 NaN，则抛出 TypeError 异常并终止这些步骤。
如果父级媒体源的 readyState 属性处于 "ended" 状态，则运行以下步骤
1. 将父级媒体源的 readyState 属性设置为 "open"
2. 排队一个任务，以在父级媒体源上触发一个名为 sourceopen 的事件。
运行范围移除算法，并以 start 和 end 作为移除范围的开始和结束。

一个轨道缓冲区存储单个轨道的轨道描述和编码帧。随着初始化片段和媒体片段添加到 SourceBuffer 中，轨道缓冲区会随之更新。

每个轨道缓冲区都有一个最后解码时间戳 (last decode timestamp) 变量，该变量存储在当前编码帧组中添加的最后一个编码帧的解码时间戳。该变量最初处于未设置状态，表示尚未添加任何编码帧。

每个轨道缓冲区都有一个最后帧时长 (last frame duration) 变量，该变量存储在当前编码帧组中添加的最后一个编码帧的编码帧时长。该变量最初处于未设置状态，表示尚未添加任何编码帧。

每个轨道缓冲区（track buffer）都有一个最高结束时间戳变量，用于存储当前编码帧组中所有已追加到此轨道缓冲区的编码帧的最大编码帧结束时间戳。该变量初始为未设置状态，以表明尚未追加任何编码帧。

每个轨道缓冲区都有一个需要随机访问点标记变量，用于跟踪轨道缓冲区是否正在等待一个随机访问点编码帧。该变量初始设为 true，以表明在向轨道缓冲区添加任何内容之前，需要一个随机访问点编码帧。

每个轨道缓冲区都有一个轨道缓冲区范围变量，用于表示当前存储在轨道缓冲区中的编码帧所占用的呈现时间范围。

注

对于轨道缓冲区范围，这些呈现时间范围基于呈现时间戳、帧持续时间，以及在多路复用的 SourceBuffer 中跨轨道缓冲区的编码帧组起始时间。

出于规范目的，此信息被视为存储在归一化 TimeRanges 对象中。交叉的轨道缓冲区范围用于报告 HTMLMediaElement 的 buffered 属性，因此必须支持 HTMLMediaElement 的 buffered 属性的每个范围内实现不间断播放。

注

这些编码帧组的起始时间与编码帧处理算法中提到的那些略有不同，因为它们是跨越不连续点后所有轨道缓冲区中最早的呈现时间戳。无论 mode 如何，不连续点都可能出现在编码帧处理算法内，或由编码帧移除算法导致。确定轨道缓冲区范围不相交的阈值取决于具体的实现。例如，为了减少意外的播放停顿，实现可以通过合并被小于该轨道缓冲区中目前已缓冲的最大帧持续时间 2 倍的间隙分隔的相邻范围，来近似处理编码帧处理算法的不连续性检测逻辑。实现 还可以 使用多路复用 SourceBuffer 中跨轨道缓冲区的编码帧组起始时间作为范围起始时间，以进一步减少意外的播放停顿。

事件名称	Interface	调度时间：当……时
updatestart	`Event`	`SourceBuffer` 的 `updating` 属性从 false 转换为 true。
update	`Event`	`SourceBuffer` 的追加或移除操作成功完成。`SourceBuffer` 的 `updating` 属性从 true 转换为 false。
updateend	`Event`	`SourceBuffer` 的追加或移除操作已结束。
error	`Event`	向 `SourceBuffer` 追加数据期间发生错误。`updating` 属性从 true 转换为 false。
abort (中止)	`Event`	`SourceBuffer` 的追加操作已被 `abort()` 调用终止。`updating` 属性从 true 转换为 false。

每个 SourceBuffer 对象都有一个 [[追加状态]] 内部槽位，用于跟踪高层分段解析状态。它最初被设置为 WAITING_FOR_SEGMENT，并随着数据追加可以转换到以下状态。

追加状态名称	描述
WAITING_FOR_SEGMENT	正在等待要追加的初始化分段或媒体分段的开始。
PARSING_INIT_SEGMENT	当前正在解析一个初始化分段。
PARSING_MEDIA_SEGMENT	当前正在解析一个媒体分段。

每个 SourceBuffer 对象都有一个 [[输入缓冲区]] 内部槽位，它是一个字节缓冲区，用于在 appendBuffer() 调用之间保留未解析的字节。当 SourceBuffer 对象创建时，该缓冲区为空。

每个 SourceBuffer 对象都有一个 [[缓冲区已满标记]] 内部槽位，用于跟踪 appendBuffer() 是否被允许接受更多字节。它在 SourceBuffer 对象创建时设置为 false，并随着数据的追加和移除进行更新。

每个 SourceBuffer 对象都有一个 [[组起始时间戳]] 内部槽位，用于跟踪 "sequence" 模式下新编码帧组的起始时间戳。当 SourceBuffer 对象创建时，它处于未设置状态，并在 mode 属性等于 "sequence" 且设置了 timestampOffset 属性时，或者执行编码帧处理算法时进行更新。

每个 SourceBuffer 对象都有一个 [[组结束时间戳]] 内部槽位，存储当前编码帧组中所有编码帧的最大编码帧结束时间戳。当 SourceBuffer 对象创建时，它被设为 0，并由编码帧处理算法更新。

注

[[组结束时间戳]] 存储 SourceBuffer 中所有轨道缓冲区的最大编码帧结束时间戳。因此，在追加时间戳跨轨道不对齐的多路复用分段时，设置 mode 属性时应格外小心。

每个 SourceBuffer 对象都有一个 [[生成时间戳标记]] 内部槽位，这是一个布尔值，用于跟踪是否需要为传递给编码帧处理算法的编码帧生成时间戳。此标记在 SourceBuffer 对象创建时由 addSourceBuffer() 设置，并由 changeType() 更新。

当调用分段解析器循环算法时，执行以下步骤

循环顶部： 如果 [[输入缓冲区]] 为空，则跳转到下方的 需要更多数据 步骤。
如果 [[输入缓冲区]] 包含违反 SourceBuffer 字节流格式规范的字节，则运行追加错误算法并中止此算法。
从 [[输入缓冲区]] 的开头移除所有字节流格式规范指明必须忽略的字节。
如果 [[追加状态]] 等于 WAITING_FOR_SEGMENT，则执行以下步骤
1. 如果 [[输入缓冲区]] 的开头指示初始化分段的开始，则将 [[追加状态]] 设置为 PARSING_INIT_SEGMENT。
2. 如果 [[输入缓冲区]] 的开头指示媒体分段的开始，则将 [[追加状态]] 设置为 PARSING_MEDIA_SEGMENT。
3. 跳转到上述 循环顶部 步骤。
如果 [[追加状态]] 等于 PARSING_INIT_SEGMENT，则执行以下步骤
1. 如果 [[输入缓冲区]] 尚不包含完整的初始化分段，则跳转到下方的 需要更多数据 步骤。
2. 运行初始化分段已接收算法。
3. 从 [[输入缓冲区]] 的开头移除初始化分段字节。
4. 将 [[追加状态]] 设置为 WAITING_FOR_SEGMENT。
5. 跳转到上述 循环顶部 步骤。
如果 [[追加状态]] 等于 PARSING_MEDIA_SEGMENT，则执行以下步骤
1. 如果 [[首次初始化分段已接收标记]] 为 false，或者 [[changeType 挂起的初始化分段标记]] 为 true，则运行追加错误算法并中止此算法。
2. 如果 [[输入缓冲区]] 包含一个或多个完整的编码帧，则运行编码帧处理算法。
  注
  运行编码帧处理算法的频率取决于实现。当输入缓冲区包含完整的媒体分段时，可以调用编码帧处理算法，或者当完整的编码帧被添加到输入缓冲区时，也可以多次调用它。
3. 如果此 SourceBuffer 已满且无法接受更多媒体数据，则将 [[缓冲区已满标记]] 设置为 true。
4. 如果 [[输入缓冲区]] 不包含完整的媒体分段，则跳转到下方的 需要更多数据 步骤。
5. 从 [[输入缓冲区]] 的开头移除媒体分段字节。
6. 将 [[追加状态]] 设置为 WAITING_FOR_SEGMENT。
7. 跳转到上述 循环顶部 步骤。
需要更多数据： 将控制权交还给调用算法。

当需要重置解析器状态时，执行以下步骤

如果 [[追加状态]] 等于 PARSING_MEDIA_SEGMENT 且 [[输入缓冲区]] 包含一些完整的编码帧，则运行编码帧处理算法，直到所有这些完整的编码帧都已处理完毕。
取消所有轨道缓冲区上的最后解码时间戳。
取消所有轨道缓冲区上的最后一帧持续时间。
取消所有轨道缓冲区上的最高结束时间戳。
将所有轨道缓冲区上的需要随机访问点标记设置为 true。
如果 mode 属性等于 "sequence"，则将 [[组起始时间戳]] 设置为 [[组结束时间戳]]。
移除 [[输入缓冲区]] 中的所有字节。
将 [[追加状态]] 设置为 WAITING_FOR_SEGMENT。

当追加期间发生错误时，将调用此算法。

运行重置解析器状态算法。
将 updating 属性设置为 false。
排队一个任务，在此 SourceBuffer 对象上触发一个事件，命名为 error。
排队一个任务，在此 SourceBuffer 对象上触发一个事件，命名为 updateend。
运行流结束算法，并将 error 参数设置为 "decode"。

当追加操作开始时，运行以下步骤来验证并准备 SourceBuffer。

如果 SourceBuffer 已从父级媒体源的 sourceBuffers 属性中移除，则抛出 InvalidStateError 异常并中止这些步骤。
如果 updating 属性等于 true，则抛出 InvalidStateError 异常并中止这些步骤。
令 最近元素错误 确定如下

如果 MediaSource 是在 Window 中构造的

如果 HTMLMediaElement 的 error 属性不为 null，则令 最近元素错误 为 true。如果该属性为 null，则令 最近元素错误 为 false。

否则

令 最近元素错误 为 Window 情况下的步骤结果，但在 Window 的 HTMLMediaElement 上运行，并在其 error 属性发生任何变化时，通过使用 [[port to worker]] 隐式消息进行通信。如果尚未收到此类消息，则令 最近元素错误 为 false。
如果 最近元素错误 为 true，则抛出 InvalidStateError 异常并中止这些步骤。
如果父级媒体源的 readyState 属性处于 "ended" 状态，则执行以下步骤
1. 将父级媒体源的 readyState 属性设置为 "open"
2. 排队一个任务，在父级媒体源上触发一个事件，命名为 sourceopen。
运行编码帧驱逐算法。
如果 [[缓冲区已满标记]] 等于 true，则抛出 QuotaExceededError 异常并中止这些步骤。
注
这是实现无法驱逐足够数据以容纳此次追加，或者追加内容过大的信号。Web 应用程序应当使用 remove() 显式释放空间和/或减小追加大小。

当调用 appendBuffer() 时，运行以下步骤来处理追加的数据。

运行分段解析器循环算法。
如果上一步中的分段解析器循环算法被中止，则中止此算法。
将 updating 属性设置为 false。
排队一个任务，在此 SourceBuffer 对象上触发一个事件，命名为 update。
排队一个任务，在此 SourceBuffer 对象上触发一个事件，命名为 updateend。

当调用者需要发起一个 JavaScript 可见的范围移除操作，且该操作会阻塞其他 SourceBuffer 更新时，请遵循以下步骤

令 start 等于移除范围的起始呈现时间戳，单位为秒，从呈现开始时间测量。
令 end 等于移除范围的结束呈现时间戳，单位为秒，从呈现开始时间测量。
将 updating 属性设置为 true。
排队一个任务，在此 SourceBuffer 对象上触发一个事件，命名为 updatestart。
将控制权交还给调用者，并异步运行其余步骤。
运行编码帧移除算法，以 start 和 end 作为移除范围的起始和结束。
将 updating 属性设置为 false。
排队一个任务，在此 SourceBuffer 对象上触发一个事件，命名为 update。
排队一个任务，在此 SourceBuffer 对象上触发一个事件，命名为 updateend。

当分段解析器循环成功解析出完整的初始化分段时，运行以下步骤

每个 SourceBuffer 对象都有一个 [[首次初始化分段已接收标记]] 内部槽位，用于跟踪第一个初始化分段是否已被追加并由此算法接收。当 SourceBuffer 创建时，此标记被设为 false，并由下述算法更新。

每个 SourceBuffer 对象都有一个 [[changeType 挂起的初始化分段标记]] 内部槽位，用于跟踪自最近一次 changeType() 调用以来，是否需要初始化分段。此标记在 SourceBuffer 创建时设为 false，由 changeType() 设置为 true，并由下述算法重置为 false。

如果 duration 属性当前等于 NaN，则更新它。

如果初始化分段包含时长

运行时长变更算法，将 新时长 设置为初始化分段中的时长。
否则

运行时长变更算法，将 新时长 设置为正无穷大。
如果初始化分段不包含任何音频、视频或文本轨道，则运行追加错误算法并中止这些步骤。
如果 [[首次初始化分段已接收标记]] 为 true，则执行以下步骤
1. 验证以下属性。如果任何检查失败，则运行追加错误算法并中止这些步骤。
2. 音频、视频和文本轨道的数量与第一个初始化分段中的内容一致。
3. 如果存在单一类型的多个轨道（例如，2 个音频轨道），则轨道 ID 与第一个初始化分段中的 ID 匹配。
4. 用户代理支持每个轨道的编解码器。
  注
  用户代理可以在此处将原本支持的编解码器视为“不支持”，如果这些编解码器未指定在传递给 (a) 此 SourceBuffer 对象上最近一次成功的 changeType() 的 type 参数中，或者 (b) 如果此对象上尚未发生成功的 changeType()，则为创建此 SourceBuffer 对象的 addSourceBuffer()。例如，如果最近一次成功的 changeType() 是使用 'video/webm' 或 'video/webm; codecs="vp8"' 调用的，而初始化分段中出现了包含 vp9 的视频轨道，则用户代理可以使用此步骤触发解码错误，即使上述其他两个属性的检查通过。鼓励实现在此类情况下仅当编解码器确实不受支持或上述其他两个属性检查失败时才触发错误。鼓励 Web 作者使用带有精确编解码器参数的 changeType()、addSourceBuffer() 和 isTypeSupported()，以便更主动地检测用户代理支持。如果 SourceBuffer 对象的字节流格式发生变化，则需要 changeType()。
5. 将此初始化分段中的相应轨道描述添加到每个轨道缓冲区。
6. 将所有轨道缓冲区上的需要随机访问点标记设置为 true。
令 活动轨道标记 等于 false。
如果 [[首次初始化分段已接收标记]] 为 false，则执行以下步骤
1. 如果初始化分段包含用户代理不支持的编解码器轨道，则运行追加错误算法并中止这些步骤。
  注
  用户代理可以在此处将原本支持的编解码器视为“不支持”，如果这些编解码器未指定在传递给 (a) 此 SourceBuffer 对象上最近一次成功的 changeType() 的 type 参数中，或者 (b) 如果此对象上尚未发生成功的 changeType()，则为创建此 SourceBuffer 对象的 addSourceBuffer()。例如，MediaSource.isTypeSupported('video/webm;codecs="vp8,vorbis"') 可能返回 true，但如果调用 addSourceBuffer() 时使用了 'video/webm;codecs="vp8"'，而初始化分段中出现了 Vorbis 轨道，则用户代理可以使用此步骤触发解码错误。鼓励实现在此类情况下仅当编解码器确实不受支持时才触发错误。鼓励 Web 作者使用带有精确编解码器参数的 changeType()、addSourceBuffer() 和 isTypeSupported()，以便更主动地检测用户代理支持。如果 SourceBuffer 对象的字节流格式发生变化，则需要 changeType()。
2. 对于初始化分段中的每个音频轨道，运行以下步骤
  1. 令 音频字节流轨道 ID 为当前正在处理的轨道的轨道 ID。
  2. 令 音频语言 为初始化分段中为该轨道指定的语言的 BCP 47 语言标签，如果没有语言信息，则为空字符串。
  3. 如果 音频语言 等于 'und' BCP 47 值，则将空字符串赋值给 音频语言。
  4. 令 音频标签 为初始化分段中为该轨道指定的标签，如果没有标签信息，则为空字符串。
  5. 令 音频类型 为初始化分段中为该轨道指定的类型字符串序列，如果没有提供类型信息，则为包含单个空字符串元素的序列。
  6. 对于 音频类型 中的每个值，运行以下步骤
  7. 令 当前音频类型 等于此循环迭代中来自 音频类型 的值。
  8. 令 新音频轨道 为一个新的 AudioTrack 对象。
  9. 生成一个唯一 ID 并将其赋值给 新音频轨道 上的 id 属性。
  10. 将 音频语言 赋值给 新音频轨道 上的 language 属性。
  11. 将 音频标签 赋值给 新音频轨道 上的 label 属性。
  12. 将 当前音频类型 赋值给 新音频轨道 上的 kind 属性。
  13. 如果此 SourceBuffer 对象 audioTracks 的 length 等于 0，则运行以下步骤
    1. 将 新音频轨道 上的 enabled 属性设置为 true。
    2. 将 活动轨道标记 设置为 true。
  14. 将 新音频轨道 添加到此 SourceBuffer 对象上的 audioTracks 属性。
    注
    这应该触发 AudioTrackList [HTML] 逻辑来排队一个任务，以触发名为 addtrack 的事件，使用 TrackEvent，并将 track 属性初始化为 新音频轨道，于此 SourceBuffer 对象上的 audioTracks 属性所引用的 AudioTrackList 对象上。
  15. 如果父级媒体源是在 DedicatedWorkerGlobalScope 中构造的
    向 [[port to main]] 发送一条内部的 create track mirror 消息，其在 Window 中的隐式处理程序运行以下步骤
    令 镜像音频轨道 为一个新的 AudioTrack 对象。
    将为 新音频轨道 确定的相同属性值赋值给 镜像音频轨道。
    将 镜像音频轨道 添加到 HTMLMediaElement 上的 audioTracks 属性。
  否则
  
  将 新音频轨道 添加到 HTMLMediaElement 上的 audioTracks 属性。
  注
  这应该触发 AudioTrackList [HTML] 逻辑来排队一个任务，以触发名为 addtrack 的事件，使用 TrackEvent，并将 track 属性初始化为 镜像音频轨道 或 新音频轨道，于 HTMLMediaElement 上 audioTracks 属性所引用的 AudioTrackList 对象上。
创建一个新的轨道缓冲区来为该轨道存储编码帧。
将此轨道的轨道描述添加到轨道缓冲区。

对于初始化分段中的每个视频轨道，运行以下步骤

令 视频字节流轨道 ID 为当前正在处理的轨道的轨道 ID。
令 视频语言 为初始化分段中为该轨道指定的语言的 BCP 47 语言标签，如果没有语言信息，则为空字符串。
如果 视频语言 等于 'und' BCP 47 值，则将空字符串赋值给 视频语言。
令 视频标签 为初始化分段中为该轨道指定的标签，如果没有标签信息，则为空字符串。
令 视频类型 为初始化分段中为该轨道指定的类型字符串序列，如果没有提供类型信息，则为包含单个空字符串元素的序列。
对于 视频类型 中的每个值，运行以下步骤
令 当前视频类型 等于此循环迭代中来自 视频类型 的值。
令 新视频轨道 为一个新的 VideoTrack 对象。
生成一个唯一 ID 并将其赋值给 新视频轨道 上的 id 属性。
将 视频语言 赋值给 新视频轨道 上的 language 属性。
将 视频标签 赋值给 新视频轨道 上的 label 属性。
将 当前视频类型 赋值给 新视频轨道 上的 kind 属性。
如果此 SourceBuffer 对象 videoTracks 的 length 等于 0，则运行以下步骤
1. 将 新视频轨道 上的 selected 属性设置为 true。
2. 将 活动轨道标记 设置为 true。
将 新视频轨道 添加到此 SourceBuffer 对象上的 videoTracks 属性。
注
这应该触发 VideoTrackList [HTML] 逻辑来排队一个任务，以触发名为 addtrack 的事件，使用 TrackEvent，并将 track 属性初始化为 新视频轨道，于此 SourceBuffer 对象上的 videoTracks 属性所引用的 VideoTrackList 对象上。
如果父级媒体源是在 DedicatedWorkerGlobalScope 中构造的
向 [[port to main]] 发送一条内部的 create track mirror 消息，其在 Window 中的隐式处理程序运行以下步骤
令 镜像视频轨道 为一个新的 VideoTrack 对象。
将为 新视频轨道 确定的相同属性值赋值给 镜像视频轨道。
将 镜像视频轨道 添加到 HTMLMediaElement 上的 videoTracks 属性。

否则

将 新视频轨道 添加到 HTMLMediaElement 上的 videoTracks 属性。

注

这应该触发 VideoTrackList [HTML] 逻辑来排队一个任务，以触发名为 addtrack 的事件，使用 TrackEvent，并将 track 属性初始化为 镜像视频轨道 或 新视频轨道，于 HTMLMediaElement 上 videoTracks 属性所引用的 VideoTrackList 对象上。

创建一个新的轨道缓冲区来为该轨道存储编码帧。

将此轨道的轨道描述添加到轨道缓冲区。

对于初始化分段中的每个文本轨道，运行以下步骤

令 文本字节流轨道 ID 为当前正在处理的轨道的轨道 ID。
令 文本语言 为初始化分段中为该轨道指定的语言的 BCP 47 语言标签，如果没有语言信息，则为空字符串。
如果 文本语言 等于 'und' BCP 47 值，则将空字符串赋值给 文本语言。
令 文本标签 为初始化分段中为该轨道指定的标签，如果没有标签信息，则为空字符串。
令 文本类型 为初始化分段中为该轨道指定的类型字符串序列，如果没有提供类型信息，则为包含单个空字符串元素的序列。
对于 text kinds 中的每个值，运行以下步骤：
1. 令 current text kind 等于本次循环迭代中来自 text kinds 的值。
2. 令 new text track 为一个新的 TextTrack 对象。
3. 生成一个唯一 ID，并将其赋值给 new text track 的 id 属性。
4. 将 text language 赋值给 new text track 的 language 属性。
5. 将 text label 赋值给 new text track 的 label 属性。
6. 将 current text kind 赋值给 new text track 的 kind 属性。
7. 使用来自初始化段的适当信息填充 new text track 的剩余属性。
8. 如果 new text track 的 mode 属性等于 "showing" 或 "hidden"，则将 active track flag 设为 true。
9. 将 new text track 添加到此 SourceBuffer 对象的 textTracks 属性中。
  注
  这应触发 TextTrackList [HTML] 逻辑以排队一个任务，使用 TrackEvent 触发一个事件，该事件名为 addtrack，并将 track 属性初始化为 new text track，目标对象为该 SourceBuffer 对象上 textTracks 属性所引用的 TextTrackList 对象。
10. 如果父媒体源构建于 DedicatedWorkerGlobalScope 中
  向 [[port to main]] 发送一个内部的 create track mirror 消息，其在 Window 中的隐式处理器将运行以下步骤：
  1. 令 mirrored text track 为一个新的 TextTrack 对象。
  2. 为 mirrored text track 分配与为 new text track 所确定的相同的属性值。
  3. 将 mirrored text track 添加到 HTMLMediaElement 的 textTracks 属性中。
  否则
  
  将 new text track 添加到 HTMLMediaElement 的 textTracks 属性中。
  注
  这应触发 TextTrackList [HTML] 逻辑以排队一个任务，使用 TrackEvent 触发一个事件，该事件名为 addtrack，并将 track 属性初始化为 mirrored text track 或 new text track，目标对象为 HTMLMediaElement 上 textTracks 属性所引用的 TextTrackList 对象。
创建一个新的轨道缓冲区以存储该轨道的编码帧。
将该轨道的轨道描述添加到轨道缓冲区中。

如果 active track flag 等于 true，则运行以下步骤：

将此 SourceBuffer 添加到 activeSourceBuffers 中。
排队一个任务以在 activeSourceBuffers 上触发一个事件，该事件名为 addsourcebuffer。

将 [[first initialization segment received flag]] 设为 true。

将 [[pending initialization segment for changeType flag]] 设为 false。

如果 active track flag 等于 true，则运行以下步骤：

使用父媒体源的必要时镜像算法在 Window 中运行以下步骤：

如果 HTMLMediaElement 的 readyState 属性大于 HAVE_CURRENT_DATA，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_METADATA。
注
根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在 HTMLMediaElement 上触发事件。

如果父媒体源的 sourceBuffers 中的每个对象都具有 [[first initialization segment received flag]] 等于 true，则使用父媒体源的必要时镜像算法在 Window 中运行以下步骤：

如果 HTMLMediaElement 的 readyState 属性为 HAVE_NOTHING，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_METADATA。
注
根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在 HTMLMediaElement 上触发事件。如果发生了从 HAVE_NOTHING 到 HAVE_METADATA 的转换，它应触发 HTMLMediaElement 逻辑以排队一个任务，在媒体元素上触发一个事件，名为 loadedmetadata。

当完整的编码帧被段解析器循环解析完成后，运行以下步骤：

对于媒体段中的每个编码帧，运行以下步骤：
1. 循环开始
  如果 [[generate timestamps flag]] 等于 true：
  1. 令 presentation timestamp 等于 0。
  2. 令 decode timestamp 等于 0。
  否则
  1. 令 presentation timestamp 为该编码帧的显示时间戳（以秒为单位）的双精度浮点表示。
    注
    对于定时文本帧，可能需要特殊处理来确定显示和解码时间戳，因为此信息在底层格式中可能并未明确呈现，或者可能取决于帧的顺序。一些元数据轨道（如 MPEG2-TS PSI 数据）可能仅具有隐含的时间戳。针对这些情况的格式特定规则应该包含在字节流格式规范或单独的扩展规范中。
  2. 令 decode timestamp 为该编码帧的解码时间戳（以秒为单位）的双精度浮点表示。
    注
    实现无需在内部以双精度浮点表示形式存储时间戳。在此处使用该表示形式是因为它是 HTML 规范中时间戳的表示形式。这样做的目的是在不向算法增加不必要复杂性的情况下明确行为，以应对增加 timestampOffset 可能会导致底层字节流格式所使用的时间戳表示出现溢出的情况。实现可以使用它们想要的任何内部时间戳表示，但添加 timestampOffset 的行为应该与使用双精度浮点表示时发生的情况类似。
2. 令 frame duration 为编码帧持续时间（以秒为单位）的双精度浮点表示。
3. 如果 mode 等于 "sequence" 且 [[group start timestamp]] 已设置，则运行以下步骤：
  1. 将 timestampOffset 设为等于 [[group start timestamp]] 减去 presentation timestamp。
  2. 将 [[group end timestamp]] 设为等于 [[group start timestamp]]。
  3. 将所有轨道缓冲区上的需要随机访问点标志设为 true。
  4. 取消设置 [[group start timestamp]]。
4. 如果 timestampOffset 不为 0，则运行以下步骤：
  1. 将 timestampOffset 添加到 presentation timestamp 中。
  2. 将 timestampOffset 添加到 decode timestamp 中。
5. 令 track buffer 等于编码帧将要添加到的轨道缓冲区。
6. 如果已设置 track buffer 的最后解码时间戳，且 decode timestamp 小于最后解码时间戳：
  OR
  
  如果已设置 track buffer 的最后解码时间戳，且 decode timestamp 与最后解码时间戳之差大于 2 倍的最后帧持续时间：
  1. 如果 mode 等于 "segments"：
    将 [[group end timestamp]] 设为 presentation timestamp。
    如果 mode 等于 "sequence"：
    将 [[group start timestamp]] 设为等于 [[group end timestamp]]。
  2. 取消设置所有轨道缓冲区上的最后解码时间戳。
  3. 取消设置所有轨道缓冲区上的最后帧持续时间。
  4. 取消设置所有轨道缓冲区上的最高结束时间戳。
  5. 将所有轨道缓冲区上的需要随机访问点标志设为 true。
  6. 跳转至上述“循环开始”步骤，以重新处理当前的编码帧。
  否则
  
  继续。
7. 令 frame end timestamp 等于 presentation timestamp 和 frame duration 之和。
8. 如果 presentation timestamp 小于 appendWindowStart，则将需要随机访问点标志设为 true，丢弃该编码帧，并跳转至循环开头以开始处理下一个编码帧。
  注
  一些实现可能选择收集一些 presentation timestamp 小于 appendWindowStart 的编码帧，并在第一个显示时间戳大于或等于 appendWindowStart 的编码帧处生成拼接，即使该帧不是随机访问点。支持此功能需要多个解码器或高于实时速度的解码，因此目前此行为将不会作为规范要求。
9. 如果 frame end timestamp 大于 appendWindowEnd，则将需要随机访问点标志设为 true，丢弃该编码帧，并跳转至循环开头以开始处理下一个编码帧。
  注
  一些实现可能选择收集 presentation timestamp 小于 appendWindowEnd 且 frame end timestamp 大于 appendWindowEnd 的编码帧，并使用它们在收集时拼接窗口内的部分已收集编码帧，以及仅部分重叠已收集编码帧末尾的后续处理帧的起始部分。支持此功能需要多个解码器或高于实时速度的解码，因此目前此行为将不会作为规范要求。结合收集跨越 appendWindowStart 的编码帧，实现可能从而支持无缝音频拼接。
10. 如果 track buffer 上的需要随机访问点标志等于 true，则运行以下步骤：
11. 如果该编码帧不是随机访问点，则丢弃该编码帧并跳转至循环开头以开始处理下一个编码帧。
12. 将 track buffer 上的需要随机访问点标志设为 false。
令 spliced audio frame 为用于保存音频拼接信息的未设置变量。
令 spliced timed text frame 为用于保存定时文本拼接信息的未设置变量。
如果 track buffer 的最后解码时间戳未设置，且 presentation timestamp 落入 track buffer 中某个编码帧的显示区间内，则运行以下步骤：
令 overlapped frame 为 track buffer 中符合上述条件的编码帧。
如果 track buffer 包含音频编码帧：
运行音频拼接帧算法，如果返回了拼接帧，则将其赋值给 spliced audio frame。
如果 track buffer 包含视频编码帧：
1. 令 remove window timestamp 等于 overlapped frame 的显示时间戳加上 1 微秒。
2. 如果 presentation timestamp 小于 remove window timestamp，则从 track buffer 中移除 overlapped frame。
  注
  这是为了补偿在双精度浮点数和有理数之间来回转换时可能出现的帧时间戳计算中的细微误差。这种容差允许一帧替换现有帧，只要它在现有帧开始时间的 1 微秒内即可。略早于现有帧的帧由下面的移除步骤处理。
如果 track buffer 包含定时文本编码帧：
运行文本拼接帧算法，如果返回了拼接帧，则将其赋值给 spliced timed text frame。

移除 track buffer 中的现有编码帧：

如果未设置 track buffer 的最高结束时间戳：

从 track buffer 中移除所有编码帧，这些帧的显示时间戳大于或等于 presentation timestamp 且小于 frame end timestamp。

如果设置了 track buffer 的最高结束时间戳，且其小于或等于 presentation timestamp：

从 track buffer 中移除所有编码帧，这些帧的显示时间戳大于或等于最高结束时间戳且小于 frame end timestamp。

通过从 track buffer 中移除前两个步骤中移除的那些帧与这些移除帧之后下一个随机访问点之间的所有编码帧，来消除对前两个步骤中移除的编码帧的所有可能的解码依赖。

注

移除直到下一个随机访问点的所有编码帧是对解码依赖的保守估计，因为它假设在移除帧和下一个随机访问点之间的所有帧都依赖于被移除的帧。

如果已设置 spliced audio frame：: 将 spliced audio frame 添加到 track buffer 中。
如果已设置 spliced timed text frame：: 将 spliced timed text frame 添加到 track buffer 中。
否则: 将具有 presentation timestamp、decode timestamp 和 frame duration 的编码帧添加到 track buffer 中。

将 track buffer 的最后解码时间戳设为 decode timestamp。

将 track buffer 的最后帧持续时间设为 frame duration。

如果未设置 track buffer 的最高结束时间戳，或者 frame end timestamp 大于最高结束时间戳，则将 track buffer 的最高结束时间戳设为 frame end timestamp。

注

需要进行大于检查是因为编码帧之间的双向预测可能导致 presentation timestamp 不单调递增，即使解码时间戳是单调递增的。

如果 frame end timestamp 大于 [[group end timestamp]]，则将 [[group end timestamp]] 设为等于 frame end timestamp。

如果 [[generate timestamps flag]] 等于 true，则将 timestampOffset 设为等于 frame end timestamp。

如果 HTMLMediaElement 的 readyState 属性为 HAVE_METADATA，且新的编码帧导致 HTMLMediaElement 的 buffered 具有一个针对当前播放位置的 TimeRanges，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_CURRENT_DATA。

注

根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在 HTMLMediaElement 上触发事件。

如果 HTMLMediaElement 的 readyState 属性为 HAVE_CURRENT_DATA，且新的编码帧导致 HTMLMediaElement 的 buffered 具有一个包含当前播放位置以及当前播放位置之后一段时间的 TimeRanges，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_FUTURE_DATA。

注

根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在 HTMLMediaElement 上触发事件。

如果 HTMLMediaElement 的 readyState 属性为 HAVE_FUTURE_DATA，且新的编码帧导致 HTMLMediaElement 的 buffered 具有一个包含当前播放位置及足够确保不间断播放的数据的 TimeRanges，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_ENOUGH_DATA。

注

根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在 HTMLMediaElement 上触发事件。

如果媒体段包含超出当前 duration 的数据，则运行时长变更算法，并将 新时长 设为当前时长与 [[group end timestamp]] 中的最大值。

当需要从 SourceBuffer 中移除特定时间范围的编码帧时，遵循以下步骤：

令 start 为移除范围的起始显示时间戳。
令 end 为移除范围的结束显示时间戳。
对于此 SourceBuffer 中的每个轨道缓冲区，运行以下步骤：
1. 令 remove end timestamp 为 duration 的当前值。
2. 如果此轨道缓冲区具有一个大于或等于 end 的随机访问点时间戳，则将 remove end timestamp 更新为该随机访问点时间戳。
  注
  随机访问点时间戳在不同轨道之间可能不同，因为轨道内编码帧之间的依赖关系通常不同于另一轨道中的依赖关系。
3. 从该轨道缓冲区中移除包含大于或等于 start 且小于 remove end timestamp 的起始时间戳的所有媒体数据。
4. 对于每个被移除的帧，如果该帧具有等于其轨道最后解码时间戳的解码时间戳，则运行以下步骤：
  
  如果 mode 等于 "segments"：
  将 [[group end timestamp]] 设为显示时间戳。
  如果 mode 等于 "sequence"：
  将 [[group start timestamp]] 设为等于 [[group end timestamp]]。
5. 取消设置所有轨道缓冲区上的最后解码时间戳。
6. 取消设置所有轨道缓冲区上的最后帧持续时间。
7. 取消设置所有轨道缓冲区上的最高结束时间戳。
8. 将所有轨道缓冲区上的需要随机访问点标志设为 true。
通过从该轨道缓冲区中移除前一步骤中移除的那些帧与这些移除帧之后下一个随机访问点之间的所有编码帧，来消除对前一步骤中移除的编码帧的所有可能的解码依赖。
注
移除直到下一个随机访问点的所有编码帧是对解码依赖的保守估计，因为它假设在移除帧和下一个随机访问点之间的所有帧都依赖于被移除的帧。
如果此对象位于 activeSourceBuffers 中，当前播放位置大于或等于 start 且小于 remove end timestamp，且 HTMLMediaElement 的 readyState 大于 HAVE_METADATA，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_METADATA 并暂停播放。
注
根据 HTMLMediaElement 就绪状态 [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在 HTMLMediaElement 上触发事件。

注
发生此转换是因为当前位置的媒体数据已被移除。在追加当前播放位置的媒体或 3.15.5 选定/启用轨道状态的变化之前，播放无法继续。

如果 [[buffer full flag]] 等于 true 且此对象准备好接收更多字节，则将 [[buffer full flag]] 设为 false。

当追加新数据时，运行此算法以释放此 SourceBuffer 中的空间。

令 new data 等于即将追加到此 SourceBuffer 的数据。
Issue 289: 编辑建议？编码帧驱逐算法需要说明“缓冲区满标志”可能会根据 |new data| 立即更新

此处需要识别一个步骤：如果实现预测处理 new data 以及 [[input buffer]] 中任何现有字节会超过 SourceBuffer 的容量，则实现可能选择在此处将 [[buffer full flag]] 设为 true。此步骤使实现能够在接受可能溢出资源的 new data 之前，进行更主动的预先反馈。实际上，至少有一个实现已经这样做了。
如果 [[buffer full flag]] 等于 false，则中止这些步骤。
令 removal ranges 等于可以从演示中驱逐以容纳 new data 的显示时间范围列表。
注
实现可能使用不同的方法来选择 removal ranges，因此 Web 应用程序 不应该 依赖于特定行为。Web 应用程序可以使用 buffered 属性来观察缓冲数据的一部分是否已被驱逐。
对于 removal ranges 中的每个范围，运行编码帧移除算法，并使 start 和 end 分别等于该移除范围的开始和结束时间戳。

当编码帧处理算法需要为两个重叠的音频编码帧生成拼接帧时，遵循以下步骤：

令 track buffer 为将包含该拼接的轨道缓冲区。
令 new coded frame 为触发拼接需求、正在添加到 track buffer 中的新编码帧。
令 presentation timestamp 为 new coded frame 的显示时间戳。
令 decode timestamp 为 new coded frame 的解码时间戳。
令 frame duration 为 new coded frame 的编码帧持续时间。
令 overlapped frame 为 track buffer 中具有包含 presentation timestamp 的显示区间的编码帧。
根据 overlapped frame 中音频的采样率，将 presentation timestamp 和 decode timestamp 更新为最接近的音频样本时间戳。如果一个时间戳距离两个音频样本时间戳等距，则使用较高的时间戳（例如，floor(x * sample_rate + 0.5) / sample_rate）。
注
例如，给定以下值：
- overlapped frame 的显示时间戳等于 10。
- overlapped frame 的采样率等于 8000 Hz。
- presentation timestamp 等于 10.01255。
- decode timestamp 等于 10.01255。
presentation timestamp 和 decode timestamp 更新为 10.0125，因为 10.01255 更接近 10 + 100/8000 (10.0125) 而非 10 + 101/8000 (10.012625)。
如果用户代理不支持交叉淡入淡出，则运行以下步骤：
从 track buffer 中移除 overlapped frame。
向 track buffer 添加一个具有以下属性的静音帧：
显示时间戳设置为 overlapped frame 的显示时间戳。
解码时间戳设置为 overlapped frame 的解码时间戳。
编码帧持续时间设置为 presentation timestamp 和 overlapped frame 显示时间戳之间的差值。
注
一些实现可能会对插入的静音两侧的编码帧应用淡入/淡出到静音的效果，以使过渡不那么突兀。
返回调用者而不提供拼接帧。
注
这旨在允许将 new coded frame 添加到 track buffer，就像 overlapped frame 从一开始就没有在 track buffer 中一样。

令 frame end timestamp 等于 presentation timestamp 和 frame duration 之和。

令 splice end timestamp 等于 presentation timestamp 与 5 毫秒拼接持续时间之和。

令 fade out coded frames 等于 overlapped frame 以及 track buffer 中任何显示时间戳大于 presentation timestamp 且小于 splice end timestamp 的额外帧。

从 track buffer 中移除 fade out coded frames 中包含的所有帧。

返回一个具有以下属性的拼接帧：

显示时间戳设置为 overlapped frame 的显示时间戳。

解码时间戳设置为 overlapped frame 的解码时间戳。

编码帧持续时间设置为 frame end timestamp 和 overlapped frame 显示时间戳之间的差值。

淡出编码帧等于 fade out coded frames。

淡入编码帧等于 new coded frame。

注

如果 new coded frame 的持续时间小于 5 毫秒，则需要 new coded frame 之后追加的编码帧来正确渲染拼接。

拼接时间戳等于 presentation timestamp。

注

有关如何渲染此拼接帧的详细信息，请参阅音频拼接渲染算法。

当音频拼接帧算法生成的拼接帧需要由媒体元素渲染时，运行以下步骤：

令 fade out coded frames 为在拼接期间淡出的编码帧。
令 fade in coded frames 为在拼接期间淡入的编码帧。
令 presentation timestamp 为 fade out coded frames 中第一个编码帧的显示时间戳。
令 end timestamp 为 fade in coded frames 中最后一个帧的显示时间戳与编码帧持续时间之和。
令 splice timestamp 为拼接开始的显示时间戳。这对应于 fade in coded frames 中第一个帧的显示时间戳。
令 splice end timestamp 等于 splice timestamp 加上 5 毫秒。
令 fade out samples 为通过解码 fade out coded frames 生成的样本。
修剪 fade out samples，使其仅包含 presentation timestamp 和 splice end timestamp 之间的样本。
令 fade in samples 为通过解码 fade in coded frames 生成的样本。
如果 fade out samples 和 fade in samples 没有共同的采样率和声道布局，则将 fade out samples 和 fade in samples 转换为共同的采样率和声道布局。
令 output samples 为用于保存输出样本的缓冲区。
对 fade out samples 中 splice timestamp 和 splice end timestamp 之间的样本应用线性增益淡出，起始增益为 1，结束增益为 0。
对 fade in samples 中 splice timestamp 和 splice end timestamp 之间的样本应用线性增益淡入，起始增益为 0，结束增益为 1。
将 presentation timestamp 到 splice timestamp 之间的样本从 fade out samples 复制到 output samples 中。
对于 splice timestamp 和 splice end timestamp 之间的每个样本，计算 fade out samples 中的一个样本与 fade in samples 中对应样本的和，并将结果存储在 output samples 中。
将 splice end timestamp 到 end timestamp 之间的样本从 fade in samples 复制到 output samples 中。
渲染 output samples。

注

以下是该算法的图形表示。 Audio splice diagram

当编码帧处理算法需要为两个重叠的定时文本编码帧生成拼接帧时，遵循以下步骤：

令 track buffer 为将包含该拼接的轨道缓冲区。
令 new coded frame 为触发拼接需求、正在添加到 track buffer 中的新编码帧。
令 presentation timestamp 为 new coded frame 的显示时间戳。
令 decode timestamp 为 new coded frame 的解码时间戳。
令 frame duration 为 new coded frame 的编码帧持续时间。
令 frame end timestamp 等于 presentation timestamp 和 frame duration 之和。
令 first overlapped frame 为 track buffer 中具有包含 presentation timestamp 的显示区间的编码帧。
令 overlapped presentation timestamp 为 first overlapped frame 的显示时间戳。
令 overlapped frames 等于 first overlapped frame 以及 track buffer 中任何显示时间戳大于 presentation timestamp 且小于 frame end timestamp 的额外帧。
从 track buffer 中移除 overlapped frames 中包含的所有帧。
将 first overlapped frame 的编码帧持续时间更新为 presentation timestamp 减去 overlapped presentation timestamp。
将 first overlapped frame 添加到 track buffer 中。
返回调用者而不提供拼接帧。
注
这旨在允许将 new coded frame 添加到 track buffer，就像它从一开始就没有与 track buffer 中的任何帧重叠一样。

SourceBufferList 是一个用于 SourceBuffer 对象的简单容器对象。它提供只读数组访问，并在列表被修改时触发事件。

WebIDL[Exposed=(Window,DedicatedWorker)]
interface SourceBufferList : EventTarget {
  readonly attribute unsigned long length;

  attribute EventHandler onaddsourcebuffer;
  attribute EventHandler onremovesourcebuffer;

  getter SourceBuffer (unsigned long index);
};

length，类型为 unsigned long，只读: 指示列表中 SourceBuffer 对象的数量。
onaddsourcebuffer，类型为 EventHandler: addsourcebuffer 事件的事件处理器。
onremovesourcebuffer，类型为 EventHandler: removesourcebuffer 事件的事件处理器。

获取器 (getter)

允许使用数组运算符（即 []）访问列表中的 SourceBuffer 对象。

调用此方法时，用户代理必须执行以下步骤

如果 index 大于或等于 length 属性，则返回 undefined 并中止这些步骤。
返回列表中第 index 个 SourceBuffer 对象。

事件名称	Interface	调度时间：当……时
addsourcebuffer	`Event`	当 `SourceBuffer` 被添加到列表时。
removesourcebuffer	`Event`	当 `SourceBuffer` 从列表中移除时。

一个 ManagedMediaSource 是一个主动管理其内存内容的 MediaSource。与 MediaSource 不同，用户代理可以出于任何原因通过内存清理算法从其 sourceBuffers（填充有 ManagedSourceBuffer）中驱逐内容。

注意: 驱逐原因

WebIDL[Exposed=(Window,DedicatedWorker)]
interface ManagedMediaSource : MediaSource {
  constructor();
  readonly attribute boolean streaming;
  attribute EventHandler onstartstreaming;
  attribute EventHandler onendstreaming;
};

streaming

获取时

返回该属性的当前值。

事件名称	Interface	调度时间：当……时
startstreaming	`Event`	一个 `ManagedMediaSource` 的 `streaming` 属性从 `false` 变为 `true`。
endstreaming	`Event`	一个 `ManagedMediaSource` 的 `streaming` 属性从 `true` 变为 `false`。

以下步骤会定期运行，只要安排了 SourceBuffer 监控算法运行。

拥有足够确保不间断播放的受管数据是一个由实现定义的条件，用户代理在其中确定它目前拥有足够的数据来播放演示，而不会在有意义的时间段内卡顿。此条件会被不断评估，以确定何时转换 streaming 的值。这些转换指示用户代理何时认为其已缓冲足够的数据，或者何时需要更多数据。

能够以有效方式检索和缓冲数据是一个由实现定义的条件，用户代理在其中确定它可以在实现所需内存使用量的同时，以能源效率高的方式获取新数据。

运行 MediaSource 的 SourceBuffer 监控算法。
令 can play uninterrupted and efficiently 为一个标志位。如果 buffered 属性包含的 TimeRanges 覆盖了当前播放位置，且包含确保不间断播放所需的足够受管数据，并能够以高效的方式检索和缓冲数据，则该标志为真。
如果 can play uninterrupted and efficiently 的值不等于 streaming，则在媒体元素上排入一个元素任务，该任务执行以下步骤：
1. 将此对象的 streaming 属性设置为 can play uninterrupted and efficiently 的值。
2. 如果 can play uninterrupted and efficiently 为假，则在 ManagedMediaSource 上触发一个名为 startstreaming 的事件。
3. 否则，在 ManagedMediaSource 上触发一个名为 endstreaming 的事件。

对于此对象 sourceBuffers 中的每一个 buffer：
1. 运行该 buffer 的内存清理算法。

WebIDL[Exposed=(Window,DedicatedWorker)]
interface BufferedChangeEvent : Event {
  constructor(DOMString type, optional BufferedChangeEventInit eventInitDict = {});

  [SameObject] readonly attribute TimeRanges addedRanges;
  [SameObject] readonly attribute TimeRanges removedRanges;
};

dictionary BufferedChangeEventInit : EventInit {
  TimeRanges addedRanges;
  TimeRanges removedRanges;
};

addedRanges: 在上次 updatestart 和 updateend 事件（该事件应在上次运行编码帧处理算法期间发生）之间添加的时间范围。
removedRanges: 在上次 updatestart 和 updateend 事件之间移除的时间范围（该事件应在上次运行编码帧移除或编码帧回收算法期间发生，或者如果用户代理为了响应内存清理而回收了内容）。

WebIDL[Exposed=(Window,DedicatedWorker)]
interface ManagedSourceBuffer : SourceBuffer {
  attribute EventHandler onbufferedchange;
};

onbufferedchange: 一个事件处理器 IDL 属性，其事件处理器事件类型为 bufferedchange。

事件名称	Interface	调度时间：当……时
bufferedchange	`BufferedChangeEvent`	在调用 `appendBuffer()`、`remove()`、`endOfStream()` 之后，或者作为用户代理运行内存清理算法的结果，`ManagedSourceBuffer` 的缓冲范围发生了变化。

在完成对 ManagedSourceBuffer buffer 的所有操作（这些操作会导致 buffer 的 buffered 属性发生变化）后，执行以下步骤。即一旦 appendBuffer()、remove() 或内存清理算法完成。

令 previous buffered ranges 等于更改发生前的 buffered 属性。
令 new buffered ranges 等于新的 buffered TimeRanges。
令 added 等于 new buffered ranges 减去 previous buffered ranges。
令 removed 等于 previous buffered ranges 减去 new buffered ranges。
令 eventInitDict 为一个新的 BufferedChangeEventInit 字典，其 addedRanges 初始化为 added，removedRanges 初始化为 removed。
排入一个任务，使用 BufferedChangeEvent 接口并以 eventInitDict 初始化，在 buffer 上触发一个名为 bufferedchange 的事件。

如果此对象不在其 ManagedMediaSource 父级的 activeSourceBuffers 中：
1. 运行编码帧移除算法，将开始时间设置为 0，结束时间设置为正无穷大，并中止这些步骤。
令 removal ranges 为一组可从演示中回收的呈现时间范围，以确保从 currentTime 开始的不间断播放，直到此类演示能够再次被检索为止。
注
实现可以使用不同的策略来选择 removal ranges，因此 Web 应用程序不应依赖于特定的行为。Web 应用程序应监听 bufferedchange 事件，以观察缓冲数据的部分是否已被回收。
对于 removal ranges 中的每个范围，运行编码帧移除算法，并将 start 和 end 设置为该移除范围的开始和结束时间戳。

本节规定了当 MediaSource 附加到元素时，现有的 HTMLMediaElement 的 seekable 和 buffered 属性必须返回什么，以及当 HTMLMediaElement 的 srcObject 属性被设置为 MediaSourceHandle 对象时，它必须执行的操作。

该 HTMLMediaElement 的 seekable 属性根据以下步骤返回一个新的静态归一化 TimeRanges 对象：

如果 MediaSource 是在已终止或正在关闭的 DedicatedWorkerGlobalScope 中构建的，则返回一个空的 TimeRanges 对象并中止这些步骤。
注
此情况旨在处理某些实现，这些实现可能不再维护在已被 terminate() 或用户代理执行终止工作线程（例如作为 close() 执行的最终结果）的 DedicatedWorkerGlobalScope 中构建的 MediaSource 内关于已缓冲或可寻道媒体的任何先前信息。

问题 277: MSE-in-Workers：考虑（最终）在 MediaSource 工作线程终止时将附加元素转换为错误状态/媒体元素应该做什么？ mse-in-workers

在附加的工作线程 MediaSource 的上下文被销毁的情况下，是否应该有某种（最终的）媒体元素错误转换？Chromium 中对 Worker MSE 的实验性实现只是保持元素的 readyState、networkState 和 error 不变，与上下文销毁前一样，尽管 seekable 和 buffered 属性各自报告为空的 TimeRange。
令 recent duration 和 recent live seekable range 分别为 duration 和 [[live seekable range]] 的最新值，确定如下：

如果 MediaSource 是在 Window 中构建的：

将 recent duration 设置为 duration，并将 recent live seekable range 设置为 [[live seekable range]]。

否则

将 recent duration 和 recent live seekable range 分别设置为 duration 和 [[live seekable range]] 最近的值，通过处理 MediaSource 在 duration 或 [[live seekable range]] 每次更改时发送至其 [[port to main]] 的隐式消息来进行更新。
如果 recent duration 等于 NaN：

返回一个空的 TimeRanges 对象。

如果 recent duration 等于正无穷大：
1. 如果 recent live seekable range 不为空：
  1. 令 union ranges 为 recent live seekable range 与 HTMLMediaElement 的 buffered 属性的并集。
  2. 返回一个单一范围，其开始时间等于 union ranges 中的最早开始时间，结束时间等于 union ranges 中的最高结束时间，并中止这些步骤。
2. 如果 HTMLMediaElement 的 buffered 属性返回一个空的 TimeRanges 对象，则返回一个空的 TimeRanges 对象并中止这些步骤。
3. 返回一个单一范围，其开始时间为 0，结束时间等于 HTMLMediaElement 的 buffered 属性所报告的最高结束时间。
否则

返回一个单一范围，其开始时间为 0，结束时间等于 recent duration。

该 HTMLMediaElement 的 buffered 属性根据以下步骤返回一个静态归一化 TimeRanges 对象。

如果 MediaSource 是在已终止或正在关闭的 DedicatedWorkerGlobalScope 中构建的，则返回一个空的 TimeRanges 对象并中止这些步骤。
注
此情况旨在处理某些实现，这些实现可能不再维护在已被 terminate() 或用户代理执行终止工作线程（例如作为 close() 执行的最终结果）的 DedicatedWorkerGlobalScope 中构建的 MediaSource 内关于已缓冲或可寻道媒体的任何先前信息。

问题 277: MSE-in-Workers：考虑（最终）在 MediaSource 工作线程终止时将附加元素转换为错误状态/媒体元素应该做什么？ mse-in-workers

在附加的工作线程 MediaSource 的上下文被销毁的情况下，是否应该有某种（最终的）媒体元素错误转换？Chromium 中对 Worker MSE 的实验性实现只是保持元素的 readyState、networkState 和 error 不变，与上下文销毁前一样，尽管 seekable 和 buffered 属性各自报告为空的 TimeRange。
令 recent intersection ranges 确定如下：
如果 MediaSource 是在 Window 中构建的：
1. 令 recent intersection ranges 等于一个空的 TimeRanges 对象。
2. 如果 activeSourceBuffers.length 不等于 0，则运行以下步骤：
  1. 令 active ranges 为 activeSourceBuffers 中每个 SourceBuffer 对象通过 buffered 返回的范围。
  2. 令 highest end time 为 active ranges 中最大的范围结束时间。
  3. 令 recent intersection ranges 等于一个包含从 0 到 highest end time 单一范围的 TimeRanges 对象。
  4. 对于 activeSourceBuffers 中的每个 SourceBuffer 对象，运行以下步骤：
    
    令 source ranges 等于当前 SourceBuffer 上 buffered 属性返回的范围。
    
    如果 readyState 为 "ended"，则将 source ranges 中最后一个范围的结束时间设置为 highest end time。
    
    令 new intersection ranges 等于 recent intersection ranges 与 source ranges 的交集。
    将 recent intersection ranges 中的范围替换为 new intersection ranges。
否则

令 recent intersection ranges 为 Window 情况的步骤所产生的 TimeRanges，但运行时使用 MediaSource 及其 SourceBuffer 对象在其 DedicatedWorkerGlobalScope 中，并通过使用 [[port to main]] 隐式消息进行通信，这些消息在每次 activeSourceBuffers、readyState 或任何缓冲状态（该状态会改变 activeSourceBuffers 中每个 buffered 属性的任何值）更新时触发。
注
如此频繁地重新计算和通信 recent intersection ranges 的开销是允许实现灵活性的原因之一，即使用其他机制（如共享内存和锁）按需查询此信息，如跨上下文通信模型中所述。
如果此属性的当前值尚未由该算法设置，或者 recent intersection ranges 不包含与此属性当前值完全相同的范围信息，则将此属性的当前值更新为 recent intersection ranges。
返回此属性的当前值。

如果 HTMLMediaElement 的 srcObject 属性被赋予一个 MediaSourceHandle，则作为扩展的 HTMLMediaElement 的 srcObject 设置器（发生在调用该元素的加载算法之前）的同步步骤的一部分，将该 MediaSourceHandle 的 [[has ever been assigned as srcobject]] 设置为 true。

注

这可以防止再次转移该 MediaSourceHandle 对象，从而在尝试这样做时实现清晰的同步异常。

议题

MediaSourceHandle 需要添加到 HTMLMediaElement 的 MediaProvider IDL 类型定义及相关涉及媒体提供者对象的文本中。

本节指定了对 [HTML] AudioTrack 定义的扩展。

WebIDL[Exposed=(Window,DedicatedWorker)]
partial interface AudioTrack {
  readonly attribute SourceBuffer? sourceBuffer;
};

Issue 280: MSE-in-Workers: {Audio,Video,Text}Track{,List} IDL in HTML need additional DedicatedWorker in Exposed mse-in-workers

[HTML] AudioTrack 需要 Window+DedicatedWorker 暴露。

sourceBuffer 类型为 SourceBuffer，只读，可为空。

获取时，运行以下步骤：

如果此轨道是由与此轨道在相同领域 (realm) 上创建的 SourceBuffer 所创建，并且该 SourceBuffer 尚未从其父媒体源的 sourceBuffers 属性中移除：: 返回创建此轨道的 SourceBuffer。
否则: 返回 null。

注

例如，如果一个 DedicatedWorkerGlobalScope SourceBuffer 通知其内部的 create track mirror 处理器在 Window 中创建此轨道，则该轨道的 Window 副本对此属性将返回 null。

本节指定了对 [HTML] VideoTrack 定义的扩展。

WebIDL[Exposed=(Window,DedicatedWorker)]
partial interface VideoTrack {
  readonly attribute SourceBuffer? sourceBuffer;
};

Issue 280: MSE-in-Workers: {Audio,Video,Text}Track{,List} IDL in HTML need additional DedicatedWorker in Exposed mse-in-workers

[HTML] VideoTrack 需要 Window+DedicatedWorker 暴露。

sourceBuffer 类型为 SourceBuffer，只读，可为空。

获取时，运行以下步骤：

如果此轨道是由与此轨道在相同领域 (realm) 上创建的 SourceBuffer 所创建，并且该 SourceBuffer 尚未从其父媒体源的 sourceBuffers 属性中移除：: 返回创建此轨道的 SourceBuffer。
否则: 返回 null。

注

本节指定了对 [HTML] TextTrack 定义的扩展。

WebIDL[Exposed=(Window,DedicatedWorker)]
partial interface TextTrack {
  readonly attribute SourceBuffer? sourceBuffer;
};

Issue 280: MSE-in-Workers: {Audio,Video,Text}Track{,List} IDL in HTML need additional DedicatedWorker in Exposed mse-in-workers

[HTML] TextTrack 需要 Window+DedicatedWorker 暴露。

sourceBuffer 类型为 SourceBuffer，只读，可为空。

获取时，运行以下步骤：

如果此轨道是由与此轨道在相同领域 (realm) 上创建的 SourceBuffer 所创建，并且该 SourceBuffer 尚未从其父媒体源的 sourceBuffers 属性中移除：: 返回创建此轨道的 SourceBuffer。
否则: 返回 null。

注

通过 appendBuffer() 为 SourceBuffer 提供的字节构成一个逻辑字节流。这些字节流的格式和语义在字节流格式规范中定义。字节流格式注册表 [MSE-REGISTRY] 提供了传递给 addSourceBuffer()、isTypeSupported() 或 changeType() 的 MIME 类型与 SourceBuffer 使用该 MIME 类型解析新追加数据时所期望的字节流格式之间的映射。鼓励实现方为其支持的字节流格式注册映射，以促进互操作性。字节流格式注册表 [MSE-REGISTRY] 是这些映射的权威来源。如果实现声称支持注册表中列出的 MIME 类型，则其 SourceBuffer 实现必须符合注册表中列出的字节流格式规范。

注

注册表中的字节流格式规范无意定义新的存储格式。它们只是概述了现有存储格式结构中本规范的实现方将接受的子集。

注

字节流格式解析和验证是在段解析器循环算法中实现的。

本节提供了所有字节流格式规范的一般要求。

字节流格式规范必须定义初始化段和媒体段。
字节流格式应当提供从初始化段中的数据获取 AudioTrack、VideoTrack 和 TextTrack 属性值的参考。
注
如果字节流格式涵盖了一种类似于带内轨道规范 [INBANDTRACKS] 所涵盖的格式，那么它应当尝试使用相同的属性映射，以便媒体源扩展回放和非媒体源扩展回放提供相同的轨道信息。
通过仅检查字节流本身来识别段边界和段类型（初始化或媒体）必须是可能的。
当满足以下任何条件时，用户代理必须运行追加错误算法：
1. 轨道的数量和类型不一致。
  
  注
  例如，如果第一个初始化段有 2 个音频轨道和 1 个视频轨道，那么字节流中跟随其后的所有初始化段必须描述 2 个音频轨道和 1 个视频轨道。
2. 轨道 ID 在初始化段之间不相同（针对描述单一类型多轨道的段，例如 2 个音频轨道）。
3. 在初始化段之间发生不支持的编解码器更改。
  
  注
  有关详细信息和示例，请参阅初始化段接收算法、addSourceBuffer() 和 changeType()。
用户代理必须支持以下内容：
1. 如果轨道 ID 在初始化段之间发生更改，且段仅描述每种类型的一个轨道。
2. 视频帧大小更改。用户代理必须支持无缝播放。
  
  注
  如果 Web 应用程序未使用 CSS 或 HTML 属性（width/height）来限制元素大小，这将导致 <video> 显示区域更改大小。
3. 音频通道数更改。用户代理可以支持无缝处理，并可能触发下混。
  
  注
  这是一个实现质量问题，因为更改通道数可能需要重新初始化音频设备、重采样器和通道混合器，这通常是可听见的。
以下规则适用于字节流内的所有媒体段。用户代理必须：
1. 将所有时间戳映射到同一媒体时间轴。
2. 支持 timestamp 间隙小于音频帧大小的媒体段的无缝播放。用户代理不得在 buffered 属性中反映这些间隙。
  注
  这旨在简化在帧边界不总是跨编码对齐（例如 Vorbis）的音频流之间进行切换。
当初始化段与任何连续的媒体段序列的任何组合满足以下条件时，用户代理必须运行追加错误算法：
1. 媒体段中所有轨道的数量和类型（音频、视频、文本等）未被识别。
2. 未提供解码每个轨道所需的解码能力（即编解码器和编解码器参数）。
3. 对于所有加密轨道，未提供解密内容所需的加密参数（加密密钥本身除外）。
4. 未提供解码和呈现媒体段序列中最早的随机访问点以及序列中后续所有样本（按呈现时间）所需的所有信息。这尤其包括：
5. 确定视频固有宽度和高度的信息（具体而言，这需要图像或像素宽高比，连同编码分辨率）。
6. 将视频解码器输出转换为适合显示格式所需的信息。

未提供计算媒体段序列中每个样本的全局呈现时间戳所需的信息。

例如，如果 I1 与 M1、M2、M3 相关联，则上述条件必须对所有组合 I1+M1、I1+M2、I1+M1+M2、I1+M2+M3 等成立。

字节流规范必须至少定义约束，以确保上述要求成立。可以定义附加约束可以，例如为了简化实现。

除了标记为非规范性的章节外，本规范中的所有创作指南、图表、示例和注释均为非规范性内容。本规范中的其他所有内容均为规范性内容。

本文件中的关键字 MAY（可以）、MUST（必须）、MUST NOT（不得）、SHOULD（应该）和 SHOULD NOT（不应）在且仅在全部大写时，按 BCP 14 [RFC2119] [RFC8174] 中的描述进行解释，如本处所示。

示例 1

<video id="v" autoplay></video>
<script>
const video = document.getElementById("v");
const mediaSource = new MediaSource();
mediaSource.addEventListener("sourceopen", onSourceOpen);
video.src = window.URL.createObjectURL(mediaSource);

async function onSourceOpen(e) {
  const mediaSource = e.target;

  if (mediaSource.sourceBuffers.length > 0) return;

  const sourceBuffer = mediaSource.addSourceBuffer(
    'video/webm; codecs="vorbis,vp8"',
  );

  video.addEventListener("seeking", (e) => onSeeking(mediaSource, e.target));
  video.addEventListener("progress", () =>
    appendNextMediaSegment(mediaSource),
  );

  try {
    const initSegment = await getInitializationSegment();

    if (initSegment == null) {
      // Error fetching the initialization segment. Signal end of stream with an error.
      mediaSource.endOfStream("network");
      return;
    }

    // Append the initialization segment.
    sourceBuffer.addEventListener("updateend", function firstAppendHandler() {
      sourceBuffer.removeEventListener("updateend", firstAppendHandler);

      // Append some initial media data.
      appendNextMediaSegment(mediaSource);
    });

    sourceBuffer.appendBuffer(initSegment);
  } catch (error) {
    // Handle errors that might occur during initialization segment fetching.
    console.error("Error fetching initialization segment:", error);
    mediaSource.endOfStream("network");
  }
}

async function appendNextMediaSegment(mediaSource) {
  if (
    mediaSource.readyState === "closed" ||
    mediaSource.sourceBuffers[0].updating
  )
    return;

  // If we have run out of stream data, then signal end of stream.
  if (!haveMoreMediaSegments()) {
    mediaSource.endOfStream();
    return;
  }

  try {
    const mediaSegment = await getNextMediaSegment();

    // NOTE: If mediaSource.readyState == "ended", this appendBuffer() call will
    // cause mediaSource.readyState to transition to "open". The web application
    // should be prepared to handle multiple "sourceopen" events.
    mediaSource.sourceBuffers[0].appendBuffer(mediaSegment);
  }
  catch (error) {
    // Handle errors that might occur during media segment fetching.
    console.error("Error fetching media segment:", error);
    mediaSource.endOfStream("network");
  }
}

function onSeeking(mediaSource, video) {
  if (mediaSource.readyState === "open") {
    // Abort current segment append.
    mediaSource.sourceBuffers[0].abort();
  }

  // Notify the media segment loading code to start fetching data at the
  // new playback position.
  seekToMediaSegmentAt(video.currentTime);

  // Append a media segment from the new playback position.
  appendNextMediaSegment(mediaSource);
}

function onProgress(mediaSource, e) {
  appendNextMediaSegment(mediaSource);
}

// Example of async function for getting initialization segment
async function getInitializationSegment() {
  // Implement fetching of the initialization segment
  // This is just a placeholder function
}

// Example function for checking if there are more media segments
function haveMoreMediaSegments() {
  // Implement logic to determine if there are more media segments
  // This is just a placeholder function
}

// Example function for getting the next media segment
async function getNextMediaSegment() {
  // Implement fetching of the next media segment
  // This is just a placeholder function
}

// Example function for seeking to a specific media segment
function seekToMediaSegmentAt(currentTime) {
  // Implement seeking logic
  // This is just a placeholder function
}
</script>

示例 2

<script>
async function setUpVideoStream() {
  // Specific video format and codec
  const mediaType = 'video/mp4; codecs="mp4a.40.2,avc1.4d4015"';

  // Check if the type of video format / codec is supported.
  if (!window.ManagedMediaSource?.isTypeSupported(mediaType)) {
    return; // Not supported, do something else.
  }

  // Set up video and its managed source.
  const video = document.createElement("video");
  const source = new ManagedMediaSource();

  video.controls = true;

  await new Promise((resolve) => {
    video.src = URL.createObjectURL(source);
    source.addEventListener("sourceopen", resolve, { once: true });
    document.body.appendChild(video);
  });

  const sourceBuffer = source.addSourceBuffer(mediaType);

  // Set up the event handlers
  sourceBuffer.onbufferedchange = (e) => {
    console.log("onbufferedchange event fired.");
    console.log(`Added Ranges: ${timeRangesToString(e.addedRanges)}`);
    console.log(`Removed Ranges: ${timeRangesToString(e.removedRanges)}`);
  };

  source.onstartstreaming = async () => {
    const response = await fetch("./videos/bipbop.mp4");
    const buffer = await response.arrayBuffer();
    await new Promise((resolve) => {
      sourceBuffer.addEventListener("updateend", resolve, { once: true });
      sourceBuffer.appendBuffer(buffer);
    });
  };

  source.onendstreaming = async () => {
    // Stop fetching new segments here
  };
}

// Helper function...
function timeRangesToString(timeRanges) {
  const ranges = [];
  for (let i = 0; i < timeRanges.length; i++) {
    ranges.push([timeRanges.start(i), timeRanges.end(i)]);
  }
  return "[" + ranges.map(([start, end]) => `[${start}, ${end})` ) + "]";
}
</script>
<body onload="setUpVideoStream()"></body>

编辑们衷心感谢 Alex Giladi、Bob Lund、Chris Needham、Chris Poole、Chris Wilson、Cyril Concolato、Dale Curtis、David Dorwin、David Singer、Duncan Rowden、François Daoust、Frank Galligan、Glenn Adams、Jer Noble、Joe Steele、John Simmons、Kagami Sascha Rosylight、Kevin Streeter、Marcos Cáceres、Mark Vickers、Matt Ward、Matthew Gregan、Michael(tm) Smith、Michael Thornburgh、Mounir Lamouri、Paul Adenot、Philip Jägenstedt、Philippe Le Hegaret、Pierre Lemieux、Ralph Giles、Steven Robertson 和 Tatsuya Igarashi 对本规范的贡献。

[dom]: DOM Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/
[ECMASCRIPT]: ECMAScript 语言规范. Ecma International. URL: https://tc39.es/ecma262/multipage/
[FILEAPI]: 文件 API。Marijn Kruisselbrink。W3C。2024 年 12 月 4 日。W3C 工作草案。网址：https://w3org.cn/TR/FileAPI/
[HTML]: HTML 标准. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. 活标准. URL: https://html.whatwg.cn/multipage/
[infra]: Infra Standard. Anne van Kesteren; Domenic Denicola. WHATWG. Living Standard. URL: https://infra.spec.whatwg.org/
[MSE-REGISTRY]: Media Source Extensions™ 字节流格式注册表。Matthew Wolenetz; Jerry Smith; Aaron Colwell. W3C. URL: https://w3org.cn/TR/mse-byte-stream-format-registry/
[RFC2119]: Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. 1997年3月. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]: RFC 2119 关键词中大小写的歧义. B. Leiba. IETF. 2017年5月. 最佳当前实践. URL: https://www.rfc-editor.org/rfc/rfc8174
[WEBIDL]: Web IDL Standard. Edgar Chen; Timothy Gu. WHATWG. Living Standard. URL: https://webidl.spec.whatwg.org/

[INBANDTRACKS]: 从媒体容器向 HTML 中获取带内媒体资源轨道. Silvia Pfeiffer; Bob Lund. W3C. 2015年4月26日. 非官方草案. URL: https://dev.w3.org/html5/html-sourcing-inband-tracks/
[MEDIA-PLAYBACK-QUALITY]: 媒体回放质量。Mounir Lamouri; Chris Cunningham. W3C. W3C 编辑草案. URL: https://w3c.github.io/media-playback-quality/
[url]: URL 标准. Anne van Kesteren. WHATWG. 活标准. URL: https://url.spec.whatwg.org/

媒体源扩展™ (Media Source Extensions™)

摘要

本文档状态

1. 简介

1.1 目标

2. 定义

3. MediaSource 接口

3.1 handle 属性

3.2 sourceBuffers 属性

3.3 activeSourceBuffers 属性

3.4 readyState 属性

3.5 duration 属性

3.6 canConstructInDedicatedWorker 属性

3.7 addSourceBuffer() 方法

3.8 removeSourceBuffer() 方法

3.9 endOfStream() 方法

3.10 setLiveSeekableRange() 方法

3.11 clearLiveSeekableRange() 方法

3.12 isTypeSupported() 方法

3.13 事件摘要

3.14 跨上下文通信模型

3.15 算法

3.15.1 附加到媒体元素

3.15.2 从媒体元素分离

3.15.3 搜寻 (Seeking)

3.15.4 SourceBuffer 监控

3.15.5 对已选定/启用轨道状态的更改

3.15.6 时长变更 (Duration change)

3.15.7 流结束 (End of stream)

3.15.8 必要时镜像 (Mirror if necessary)

4. MediaSourceHandle 接口

4.1 传输

5. SourceBuffer 接口

5.1 属性

5.2 方法

5.3 轨道缓冲区

5.4 事件摘要

5.5 算法

5.5.1 分段解析器循环

5.5.2 重置解析器状态

5.5.3 追加错误

5.5.4 准备追加

5.5.5 缓冲区追加

5.5.6 范围移除

5.5.7 初始化分段已接收

5.5.8 编码帧处理

5.5.9 编码帧移除

5.5.10 编码帧驱逐

5.5.11 音频拼接帧

5.5.12 音频拼接渲染

5.5.13 文本拼接帧

6. SourceBufferList 接口

6.1 属性

6.2 方法

6.3 事件摘要

7. ManagedMediaSource 接口

7.1 属性

7.2 事件摘要

7.3 算法

7.3.1 ManagedSourceBuffer 监控

7.3.2 内存清理

8. BufferedChangeEvent 接口

8.1 属性

9. ManagedSourceBuffer 接口

9.1 属性

9.2 事件摘要

9.3 算法

9.3.1 缓冲区变更

9.3.2 内存清理

10. HTMLMediaElement 扩展

10.1 HTMLMediaElement 的 seekable

10.2 HTMLMediaElement 的 buffered

10.3 HTMLMediaElement 的 srcObject

11. AudioTrack 扩展

属性

12. VideoTrack 扩展

属性

13. TextTrack 扩展

属性

14. 字节流格式

3. `MediaSource` 接口

3.1 `handle` 属性

3.2 `sourceBuffers` 属性

3.3 `activeSourceBuffers` 属性

3.4 `readyState` 属性

3.5 `duration` 属性

3.6 `canConstructInDedicatedWorker` 属性

3.7 `addSourceBuffer()` 方法

3.8 `removeSourceBuffer()` 方法

3.9 `endOfStream()` 方法

3.10 `setLiveSeekableRange()` 方法

3.11 `clearLiveSeekableRange()` 方法

3.12 `isTypeSupported()` 方法

4. `MediaSourceHandle` 接口

5. `SourceBuffer` 接口

6. `SourceBufferList` 接口

7. `ManagedMediaSource` 接口

7.3.1 `ManagedSourceBuffer` 监控

8. `BufferedChangeEvent` 接口

9. `ManagedSourceBuffer` 接口

10.1 `HTMLMediaElement` 的 `seekable`

10.2 `HTMLMediaElement` 的 `buffered`

10.3 `HTMLMediaElement` 的 `srcObject`

11. `AudioTrack` 扩展

12. `VideoTrack` 扩展

13. `TextTrack` 扩展