媒体源扩展™

本规范设计时考虑了以下目标：

允许 JavaScript 构建与媒体获取方式无关的媒体流。
定义拼接和缓冲模型，便于实现自适应流媒体、广告插入、时移和视频编辑等场景。
尽量减少 JavaScript 中对媒体解析的需求。
最大化利用浏览器缓存。
为字节流格式规范提供要求。
不强制支持任何特定的媒体格式或编解码器。

本规范定义了：

用户代理的规范性行为，保障不同用户代理与 Web 应用在处理媒体数据时的互操作性。
规范性要求，使其他规范可定义在本规范中使用的媒体格式。

活动轨道缓冲区

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

追加窗口

用于追加时过滤编码帧的展示时间戳范围。追加窗口表示一个连续的时间区间，拥有起始和结束时间。展示时间戳在该区间内的编码帧可追加到 SourceBuffer，区间外的编码帧会被过滤。追加窗口的起止时间分别由 appendWindowStart 和 appendWindowEnd 属性控制。

编码帧

一组包含展示时间戳、解码时间戳和编码帧时长的媒体数据单元。

编码帧时长

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

编码帧结束时间戳

某个编码帧的展示时间戳加上其编码帧时长，表示紧跟该编码帧之后的展示时间戳。

编码帧组

一组相邻、解码时间戳单调递增且无间隙的编码帧。由编码帧处理算法和 abort() 调用检测到的间断将触发新编码帧组的开始。

解码时间戳

解码时间戳指示帧需要被解码的最晚时间（假设该帧及其依赖帧均瞬时解码和渲染），等于最早依赖该帧的展示时间戳（按展示顺序）。如能按非展示顺序解码，字节流中必须存在或可推导解码时间戳，否则用户代理必须运行追加错误算法。若不能按非展示顺序解码且字节流无解码时间戳，则解码时间戳等于展示时间戳。

初始化分段

包含解码一组媒体分段所需全部初始化信息的字节序列，包括编解码器初始化数据、复用分段的轨道ID映射、时间戳偏移（如编辑列表）等。

注

字节流格式注册表中的字节流格式规范包含格式相关示例。

媒体分段

包含某一媒体时间线片段的分包及带时间戳的媒体数据的字节序列。媒体分段总是与最近追加的初始化分段关联。

注

字节流格式注册表中的字节流格式规范包含格式相关示例。

MediaSource 对象 URL

一个 MediaSource 对象 URL 是通过 createObjectURL() 创建的唯一 blob URL。它用于将 MediaSource 对象绑定到 HTMLMediaElement。

这些 URL 与 blob URLs 相同，但其定义中凡涉及 File 和 Blob 对象的内容，也适用于 MediaSource 对象。

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

注

例如，MediaSource 对象 URL 的 origin 会影响媒体元素被 canvas 消费的方式。

父媒体源

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

展示起始时间

展示起始时间是演示中最早的时间点，指定初始播放位置和最早可能位置。所有用本规范创建的演示的展示起始时间均为0。

注

在判断 HTMLMediaElement 的 buffered 是否包含当前播放位置时，允许实现在展示起始时间及其后、首个 TimeRanges 之前的当前播放位置播放首个 TimeRanges，如果该区间在展示起始时间后很短（如1秒）内开始。这样可兼容复用流通常不会让所有轨道精确从展示起始时间开始的实际情况。实现必须报告实际缓冲区范围，不受此允许影响。

展示区间

某个编码帧的展示区间是从其展示时间戳到展示时间戳加上编码帧时长的时间区间。例如，若编码帧展示时间戳为10秒，时长为100毫秒，则展示区间为[10-10.1)。注意区间起点为包含，终点为不包含。

展示顺序

编码帧在演示中被渲染的顺序。展示顺序通过按编码帧的展示时间戳单调递增排序实现。

展示时间戳

演示中某一特定时间的引用。编码帧中的展示时间戳表示该帧应被渲染的时间。

随机访问点

媒体分段中可在不依赖前序数据的情况下开始解码和连续播放的位置。视频通常为I帧位置，音频多数帧都可视为随机访问点。由于视频轨道随机访问点分布稀疏，复用流通常以这些点为流的随机访问点。

SourceBuffer 字节流格式规范

描述 SourceBuffer 实例可接受字节流格式的字节流格式规范。字节流格式规范最初由创建对象时 addSourceBuffer() 所传 type 决定，也可通过 changeType() 方法更新。

SourceBuffer 配置

由单个 MediaSource 实例拥有的、分布于一个或多个 SourceBuffer 的特定轨道集合。

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

一个 SourceBuffer，含1个音频轨道和/或1个视频轨道。
两个 SourceBuffer，一个用于处理单一音频轨道，另一个用于处理单一视频轨道。

MediaSource 对象须支持上述每种配置，但仅需同时支持一种。支持多种或更多配置属于实现质量问题。

轨道描述

字节流格式相关结构，包含单轨道的轨道ID、编解码器配置及其他元数据。单个初始化分段中的每个轨道描述均有唯一轨道ID。如轨道ID不唯一，用户代理必须运行追加错误算法。

轨道ID

轨道ID是字节流格式相关的标识符，用于标记字节流中属于某轨道的部分。轨道描述中的轨道ID标识媒体分段的哪些部分属于该轨道。

MediaSource 接口表示用于 HTMLMediaElement 的媒体数据源。它会记录此源的 readyState 状态，以及可以用于向演示添加媒体数据的 SourceBuffer 对象列表。MediaSource 对象由 Web 应用创建，然后附加到 HTMLMediaElement。应用通过 SourceBuffer 对象与 sourceBuffers 向该源添加媒体数据。HTMLMediaElement 在播放时会从 MediaSource 对象获取媒体数据。

每个 MediaSource 对象都拥有一个 [[live seekable range]] 内部槽，用于存储一个标准化的 TimeRanges 对象。该对象在 MediaSource 创建时初始化为空的 TimeRanges 对象，通过 setLiveSeekableRange() 和 clearLiveSeekableRange() 维护，并在 10. HTMLMediaElement 扩展中用于修改 HTMLMediaElement 的 seekable 行为。

每个 MediaSource 对象都有一个 [[has ever been attached]] 内部槽，用于存储一个 boolean。在 MediaSource 创建时初始化为 false，在扩展的 HTMLMediaElement 的资源获取算法中（参见绑定到媒体元素算法）被设置为 true。扩展的资源获取算法会用此内部槽条件性地阻止通过 MediaSourceHandle 绑定到 HTMLMediaElement 的 srcObject 属性的 MediaSource 对象绑定。

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

closed: 表示该源当前未绑定到媒体元素。
open: 该源已被媒体元素打开，可以向 SourceBuffer 对象（在 MediaSource 的 sourceBuffers 属性中）追加数据。
ended: 该源仍绑定于媒体元素，但已调用 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 对象的句柄尚未创建，则执行以下步骤：
1. 令 created handle 为新建 MediaSourceHandle 对象及相关资源的结果，并与本 MediaSource 内部关联。
2. 将属性值更新为 created handle。
返回当前属性值的 MediaSourceHandle 对象。

包含与本 SourceBuffer 关联的 MediaSource 对象列表。当 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 异常并终止步骤。
如果 updating 属性在任意 SourceBuffer（在 sourceBuffers 中）上为 true，则抛出 InvalidStateError 异常并终止步骤。
使用赋值给该属性的值作为 new duration，运行时长变更算法。

注意

时长变更算法会在当前已缓冲编码帧结束时间更大时自动上调 new duration。

注意

appendBuffer() 和 endOfStream() 在某些情况下也会更新时长。

返回 true。

注意

此属性用于在主线程和专用 worker 中检测是否支持在专用 worker 创建和使用 MediaSource 对象，减少需要高延迟检测 polyfill（如尝试在专用 worker 创建 MediaSource 对象，尤其在不支持该特性时）的需求。

将新的 SourceBuffer 添加到 sourceBuffers。

如果 type 为空字符串，则抛出 TypeError 异常并终止步骤。
如果 type 包含不支持的 MIME 类型，或者包含与其他 SourceBuffer 对象指定类型不兼容的 MIME 类型，则抛出 NotSupportedError 异常并终止步骤。
如果用户代理无法再处理更多 SourceBuffer 对象，或根据 type 创建 SourceBuffer 会导致不支持的 SourceBuffer 配置，则抛出 QuotaExceededError 异常并终止步骤。

注意

例如，用户代理可以在媒体元素已达 HAVE_METADATA readyState 时抛出 QuotaExceededError 异常。这种情况可能出现在用户代理的媒体引擎不支持在播放期间添加更多轨道时。
如果 readyState 属性不处于 "open" 状态，则抛出 InvalidStateError 异常并终止步骤。
令 buffer 如果 this 是 ManagedMediaSource，则为新建 ManagedSourceBuffer 实例，否则为新建 SourceBuffer 实例，并关联各自的资源。
将 buffer 的 [[generate timestamps flag]] 设置为 Media Source Extensions™ 字节流格式注册表中与 type 关联的条目的“生成时间戳标志”值。
如果 buffer 的 [[generate timestamps flag]] 为 true，则将 buffer 的 mode 设为 "sequence"；否则设为 "segments"。
追加 buffer 到 this 的 sourceBuffers。
排队一个任务用于触发事件，事件名称为 addsourcebuffer，目标为 this 的 sourceBuffers。
返回 buffer。

从 SourceBuffer 从 sourceBuffers 移除一个 SourceBuffer。

如果 sourceBuffer 指定的对象不在 sourceBuffers 中，则抛出 NotFoundError 异常，并终止后续步骤。
如果 sourceBuffer.updating 属性为 true，则执行以下步骤：
1. 如正在运行，终止缓冲区追加算法。
2. 将 sourceBuffer.updating 属性设为 false。
3. 排队任务以触发事件，事件名为 abort，目标为 sourceBuffer。
4. 排队任务以触发事件，事件名为 updateend，目标为 sourceBuffer。
令 SourceBuffer audioTracks list 等于 sourceBuffer.audioTracks 返回的 AudioTrackList 对象。
如果 SourceBuffer audioTracks list 不为空，执行以下步骤：
1. 对 SourceBuffer audioTracks list 中的每个 AudioTrack 对象，执行：
  1. 将 sourceBuffer 属性设为 null。
  2. 从 SourceBuffer audioTracks list 中移除该 AudioTrack 对象。
    
    注意
    
    此操作应触发 AudioTrackList [HTML] 的逻辑，排队任务以触发事件，事件名为 removetrack，使用 TrackEvent，其 track 属性初始化为该 AudioTrack 对象，目标为 SourceBuffer audioTracks list。若移除步骤开始时 enabled 属性为 true，还应触发 AudioTrackList [HTML] 的逻辑，排队任务以触发事件名为 change，目标为 SourceBuffer audioTracks list。
  3. 使用必要时镜像算法，在 Window 中移除该 AudioTrack 对象（或如 MediaSource 对象是在 DedicatedWorkerGlobalScope 构造，则移除其 Window 镜像）：
    1. 令 HTMLMediaElement audioTracks list 等于 HTMLMediaElement.audioTracks 属性返回的 AudioTrackList 对象。
    2. 从 HTMLMediaElement audioTracks list 中移除该 AudioTrack 对象。
      
      注意
      
      此操作应触发 AudioTrackList [HTML] 的逻辑，排队任务以触发事件，事件名为 removetrack，使用 TrackEvent，其 track 属性初始化为该 AudioTrack 对象，目标为 HTMLMediaElement audioTracks list。如果移除步骤开始时 enabled 属性为 true，还应触发 AudioTrackList [HTML] 的逻辑，排队任务以触发事件名为 change，目标为 HTMLMediaElement audioTracks list。
令 SourceBuffer videoTracks list 等于 sourceBuffer.videoTracks 返回的 VideoTrackList 对象。
如果 SourceBuffer videoTracks list 不为空，执行以下步骤：
1. 对 SourceBuffer videoTracks list 中的每个 VideoTrack 对象，执行：
  1. 将 sourceBuffer 属性设为 null。
  2. 从 SourceBuffer videoTracks list 中移除该 VideoTrack 对象。
    
    注意
    
    此操作应触发 VideoTrackList [HTML] 的逻辑，排队任务以触发事件，事件名为 removetrack，使用 TrackEvent，其 track 属性初始化为该 VideoTrack 对象，目标为 SourceBuffer videoTracks list。若移除步骤开始时 selected 属性为 true，还应触发 VideoTrackList [HTML] 的逻辑，排队任务以触发事件名为 change，目标为 SourceBuffer videoTracks list。
  3. 使用必要时镜像算法，在 Window 中移除该 VideoTrack 对象（或如 MediaSource 对象是在 DedicatedWorkerGlobalScope 构造，则移除其 Window 镜像）：
    1. 令 HTMLMediaElement videoTracks list 等于 HTMLMediaElement.videoTracks 属性返回的 VideoTrackList 对象。
    2. 从 HTMLMediaElement videoTracks list 中移除该 VideoTrack 对象。
      
      注意
      
      此操作应触发 VideoTrackList [HTML] 的逻辑，排队任务以触发事件，事件名为 removetrack，使用 TrackEvent，其 track 属性初始化为该 VideoTrack 对象，目标为 HTMLMediaElement videoTracks list。若移除步骤开始时 selected 属性为 true，还应触发 VideoTrackList [HTML] 的逻辑，排队任务以触发事件名为 change，目标为 HTMLMediaElement videoTracks list。
令 SourceBuffer textTracks list 等于 sourceBuffer.textTracks 返回的 TextTrackList 对象。
如果 SourceBuffer textTracks list 不为空，执行以下步骤：
1. 对 SourceBuffer textTracks list 中的每个 TextTrack 对象，执行：
  1. 将 sourceBuffer 属性设为 null。
  2. 从 SourceBuffer textTracks list 中移除该 TextTrack 对象。
    
    注意
    
    此操作应触发 TextTrackList [HTML] 的逻辑，排队任务以触发事件，事件名为 removetrack，使用 TrackEvent，其 track 属性初始化为该 TextTrack 对象，目标为 SourceBuffer textTracks list。若移除步骤开始时 mode 属性为 "showing" 或 "hidden"，还应触发 TextTrackList [HTML] 的逻辑，排队任务以触发事件名为 change，目标为 SourceBuffer textTracks list。
  3. 使用必要时镜像算法，在 Window 中移除该 TextTrack 对象（或如 MediaSource 对象是在 DedicatedWorkerGlobalScope 构造，则移除其 Window 镜像）：
    1. 令 HTMLMediaElement textTracks list 等于 HTMLMediaElement.textTracks 属性返回的 TextTrackList 对象。
    2. 从 HTMLMediaElement textTracks list 中移除该 TextTrack 对象。
      
      注意
      
      此操作应触发 TextTrackList [HTML] 的逻辑，排队任务以触发事件，事件名为 removetrack，使用 TrackEvent，其 track 属性初始化为该 TextTrack 对象，目标为 HTMLMediaElement textTracks list。如果移除步骤开始时 mode 属性为 "showing" 或 "hidden"，还应触发 TextTrackList [HTML] 的逻辑，排队任务以触发事件名为 change，目标为 HTMLMediaElement textTracks list。
如果 sourceBuffer 在 activeSourceBuffers 中，则将 sourceBuffer 从 activeSourceBuffers 中移除，并排队任务以触发事件，事件名为 removesourcebuffer，目标为 SourceBufferList（由 activeSourceBuffers 返回）。
将 sourceBuffer 从 sourceBuffers 中移除，并排队任务以触发事件，事件名为 removesourcebuffer，目标为 SourceBufferList（由 sourceBuffers 返回）。
销毁 sourceBuffer 的全部资源。

标志流结束。

如果 readyState 属性不是 "open" 状态，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性在任意 SourceBuffer（在 sourceBuffers 中）上为 true，则抛出 InvalidStateError 异常并终止这些步骤。
以参数 error 调用流结束算法。

更新 [[live seekable range]]，该属性用于 10. HTMLMediaElement 扩展，以修改 HTMLMediaElement 的 seekable 行为。

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

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

更新 [[live seekable range]]，该属性用于 10. HTMLMediaElement 扩展，以修改 HTMLMediaElement 的 seekable 行为。

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

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

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

注意

若该方法返回 true，仅表示 MediaSource 实现能够为指定 MIME 类型创建 SourceBuffer 对象。若资源不足，addSourceBuffer() 调用仍应当失败。

注意

此方法返回 true 意味着 HTMLMediaElement 的 canPlayType() 通常会返回 "maybe" 或 "probably"，因为 MediaSource 不应该支持 HTMLMediaElement 明确无法播放的类型。

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

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

事件名称	接口	触发条件
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（见绑定到媒体元素算法）将其绑定到 HTMLMediaElement 对象（Window 上下文）。MediaSource 对象不是 Transferable；它只在创建时的上下文可见。

本节其余部分描述了将 Window 媒体元素绑定到 DedicatedWorkerGlobalScope 的 MediaSource 时用于约束信息延迟的模型。该模型描述了通过消息传递通信，但实现也可以采用更快的方式（如共享内存与锁）。Window 上下文的 MediaSource 绑定则同步获取信息，无需跨上下文通信。

在 DedicatedWorkerGlobalScope 构造的 MediaSource 拥有 [[port to main]] 内部槽，用于存储在绑定期间建立、解绑期间清空的 MessagePort。Window 上下文的 [[port to main]] 始终为 null。

被本规范扩展并绑定到 DedicatedWorkerGlobalScope 的 HTMLMediaElement 同样有 [[port to worker]] 内部槽（存储 MessagePort），以及 [[channel with worker]] 内部槽（存储 MessageChannel），两者在绑定期间建立、解绑期间清空。只有绑定到 DedicatedWorkerGlobalScope 的 MediaSource 时 [[port to worker]] 和 [[channel with worker]] 不为 null。

本规范中的算法若需在 Window 上下文的 HTMLMediaElement 与附加到 DedicatedWorkerGlobalScope 的 MediaSource 间通信，将隐式使用这些内部端口向对应方发送消息，消息的隐式处理程序根据算法描述运行步骤。

将 MediaSource 附加到媒体元素有不同方式，取决于该 MediaSource 对象是在哪构造的：在 Window 中，还是在 DedicatedWorkerGlobalScope 中：

将构造于 Window 的 MediaSource 进行附加，可以通过把该 MediaSource 对象 URL 赋值给媒体元素的 src 属性，或赋值给媒体元素内部某个 <source> 的 src 属性来完成。通过将一个 MediaSource 对象传给 createObjectURL() 可创建 MediaSource 对象 URL。

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

注意

将对象 URL 附加机制扩展到 worker 的 MediaSource 对象 URL 会进一步传播这种不如使用 srcObject 的习惯用法，并会不必要地增加用户代理的互操作风险和实现复杂度。
将构造于 DedicatedWorkerGlobalScope 的 MediaSource 进行附加，只能通过使用其 handle 获取句柄，将该 MediaSourceHandle 传递到 Window 上下文，并赋值给媒体元素的 srcObject 属性来完成。为与 HTMLMediaElement 的资源加载与获取算法保持一致，这里所指的底层 DedicatedWorkerGlobalScope MediaSource 即其处提到的 MediaSource 对象，而 MediaSourceHandle 对象即媒体提供者对象。

如果资源获取算法的调用中，媒体提供者对象是一个 MediaSource 对象、一个 MediaSourceHandle 对象，或其对象为 MediaSource 的 URL 记录，则令模式为本地（local），跳过资源获取算法的第一步（否则可能将模式设为远程），并继续执行该资源获取算法。

注意

预期资源获取算法的第一步最终会与“当 URL 记录的对象是媒体提供者对象时选择本地模式”的行为一致。其意图是：如果 HTMLMediaElement 的 src 属性或选中的子 source 的 src 属性在最近一次变更时是与某个 MediaSource 对象 URL 匹配的 blob: URL，那么该 MediaSource 对象会在资源获取算法的本地模式逻辑中被用作媒体提供者对象和当前媒体资源。这也意味着当 MediaSource 对象被附加时，包含对 preload 属性考量的远程模式逻辑会被跳过。即便未来在 [HTML] 中做出上述改变，在当前媒体资源是 MediaSource 对象时，仍需要在本地模式逻辑开头执行下列步骤。

在资源获取算法 “否则（模式为本地）”部分的开头，执行以下附加步骤。

注意

相对于触发媒体元素资源选择算法的动作，这些步骤是异步的。资源获取算法会在调用资源选择算法的任务被允许继续并达到稳定状态后运行。实现可以延迟“否则”子句中的步骤，直到 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]] 设为 port1，来自 [[channel with worker]] 的值。
  
  对 port2 执行 StructuredSerializeWithTransfer，将其同时作为值与 transferList 的唯一成员，结果记为 serialized port2。
  
  在队列中添加一个任务到该 MediaSource 的 DedicatedWorkerGlobalScope，使其将会
  
  使用 serialized port2 和 DedicatedWorkerGlobalScope 的 realm 执行 StructuredDeserializeWithTransfer，并将 [[port to main]] 设为传输的 port2 值的反序列化克隆，来自 [[channel with worker]]。
  
  将 readyState 属性设为 "open"。
  
  排队一个任务以触发事件，事件名为 sourceopen，目标为 MediaSource。
  
  否则，该 MediaSource 构造于 Window：
  
  将 [[channel with worker]] 设为 null。
  
  将 [[port to worker]] 设为 null。
  
  将 [[port to main]] 设为 null。
  
  将 readyState 属性设为 "open"。
  
  排队一个任务以触发事件，事件名为 sourceopen，目标为 MediaSource。
4. 继续运行资源获取算法的剩余 “否则（模式为本地）” 步骤，并遵循以下要求：
  1. 资源获取算法或媒体数据处理步骤列表中提到的“下载”“接收的字节数”或“每当当前媒体资源有新数据可用”之类表述，均指通过 appendBuffer() 传入的数据。
  2. 资源获取算法和媒体数据处理步骤列表中与 HTTP 相关的内容不适用，因为当 MediaSource 已附加时，HTMLMediaElement 不会通过 HTTP 获取媒体数据。

注意

已附加的 MediaSource 不会使用资源获取算法中的远程模式步骤，因此媒体元素不会触发 “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 对象。
排队一个任务以触发事件 removesourcebuffer 到 activeSourceBuffers。
从 sourceBuffers 中移除所有 SourceBuffer 对象。
排队一个任务以触发事件 removesourcebuffer 到 sourceBuffers。
排队一个任务以触发事件 sourceclose 到 MediaSource。

注意

展望未来，当已附加的（如果有）MediaSource 必须从媒体元素解绑时，预期外部调用并运行此算法。除了或替代媒体元素切换到 NETWORK_EMPTY 的情形外，它可以在 HTMLMediaElement [HTML] 的 load() 操作以及资源获取算法失败时被调用。资源获取算法失败是指中止资源获取算法或资源选择算法的那些情况，但“最终步骤”（Final step） [HTML] 不视为触发解绑的失败。

作为 seek 算法中“等待用户代理确定新播放位置的媒体数据是否可用；若可用，等待其已解码足够数据以播放该位置” 步骤的一部分，运行以下步骤：

注意

媒体元素会在 SourceBuffer 对象（位于 activeSourceBuffers 中）中查找包含媒体分段的 new playback position。在当前 HTMLMediaElement 的 buffered 属性值中的任何 TimeRanges 范围内的位置，都已为该位置缓冲了所有必要的媒体分段。
如果 new playback position 不在 TimeRanges 中（来自 HTMLMediaElement 的 buffered）
1. 如果 HTMLMediaElement 的 readyState 属性大于 HAVE_METADATA，则将其 readyState 设为 HAVE_METADATA。
  
  注意
  
  按照 HTMLMediaElement ready states [HTML] 的逻辑， HTMLMediaElement 的 readyState 变化可能触发该元素上的事件。
2. 媒体元素等待一次 appendBuffer() 调用，使编码帧处理算法将 HTMLMediaElement 的 readyState 设为大于 HAVE_METADATA 的值。
  
  注意
  
  Web 应用可以使用 buffered 以及 HTMLMediaElement 的 buffered 来判定媒体元素恢复播放所需的数据。
否则

继续

注意

如果 readyState 属性为 "ended"，且 new playback position 位于当前 HTMLMediaElement 的 buffered 所含的某个 TimeRanges 中，那么即使一个或多个当前选中或启用的轨道缓冲区的最大范围结束时间戳小于 new playback position，也必须在此继续完成 seek 操作。该情况应仅因 buffered 在 readyState 为 "ended" 时的逻辑而出现。
媒体元素重置所有解码器，并使用相应初始化分段的数据对每个解码器进行初始化。
媒体元素从活动轨道缓冲区向解码器馈送编码帧，起始于位于 new playback position 之前最近的随机访问点。
在“等待稳定状态”步骤恢复 seek 算法。

在播放过程中会定期运行以下步骤，以确保 SourceBuffer 对象（位于 activeSourceBuffers 中）具有足够数据以确保不间断播放。对 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 ready states [HTML] 的逻辑， HTMLMediaElement 的 readyState 变化可能触发该元素上的事件。
终止这些步骤。

如果 HTMLMediaElement 的 buffered 包含覆盖当前播放位置的 TimeRanges 且具有足够数据以确保不间断播放：

将 HTMLMediaElement 的 readyState 属性设为 HAVE_ENOUGH_DATA。

注意

按照 HTMLMediaElement ready states [HTML] 的逻辑， HTMLMediaElement 的 readyState 变化可能触发该元素上的事件。
如果此前因切换到 HAVE_CURRENT_DATA 而暂停播放，则此时可能恢复播放。
终止这些步骤。

如果 HTMLMediaElement 的 buffered 包含覆盖当前播放位置并向后延伸一段时间的 TimeRanges，则运行以下步骤：

将 HTMLMediaElement 的 readyState 属性设为 HAVE_FUTURE_DATA。

注意

按照 HTMLMediaElement ready states [HTML] 的逻辑， HTMLMediaElement 的 readyState 变化可能触发该元素上的事件。
如果此前因切换到 HAVE_CURRENT_DATA 而暂停播放，则此时可能恢复播放。
终止这些步骤。

如果 HTMLMediaElement 的 buffered 包含的 TimeRanges 正好在当前播放位置结束，且在当前位置之后没有覆盖的范围：

将 HTMLMediaElement 的 readyState 属性设为 HAVE_CURRENT_DATA。

注意

按照 HTMLMediaElement ready states [HTML] 的逻辑， HTMLMediaElement 的 readyState 变化可能触发该元素上的事件。
此时播放被暂停，因为媒体元素没有足够数据推进媒体时间线。
终止这些步骤。

在播放过程中，如果 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. 排队一个任务以触发事件 removesourcebuffer 到 activeSourceBuffers
如果与新选中的视频轨道关联的 SourceBuffer 尚未位于 activeSourceBuffers 中，则运行以下步骤：
1. 将该 SourceBuffer 添加到 activeSourceBuffers。
2. 排队一个任务以触发事件 addsourcebuffer 到 activeSourceBuffers

如果某音频轨道变为禁用，且与该轨道关联的 SourceBuffer 未与任何其他启用或选中的轨道关联，则运行以下步骤：

从 activeSourceBuffers 中移除与该音频轨道关联的 SourceBuffer。
排队一个任务以触发事件 removesourcebuffer 到 activeSourceBuffers

如果某音频轨道变为启用，且与该轨道关联的 SourceBuffer 尚未位于 activeSourceBuffers 中，则运行以下步骤：

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

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

从 activeSourceBuffers 中移除与该文本轨道关联的 SourceBuffer
排队一个任务以触发事件 removesourcebuffer 到 activeSourceBuffers

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

将与该文本轨道关联的 SourceBuffer 添加到 activeSourceBuffers
排队一个任务以触发事件 addsourcebuffer 到 activeSourceBuffers

当 duration 需要变更为 new duration 时，按照以下步骤操作。

如果当前 duration 的值等于 new duration，则直接返回。
如果 new duration 小于所有 SourceBuffer（在 sourceBuffers 中）缓冲的所有编码帧的最大展示时间戳，则抛出 InvalidStateError 异常并终止这些步骤。

注意

不允许缩短时长导致当前已缓冲的媒体被截断。如需截断，应先用 remove() 减少缓冲范围，再更新 duration。
令 highest end time 为所有 SourceBuffer（在 sourceBuffers 中）内所有轨道缓冲区的缓冲区范围最大结束时间。
如果 new duration 小于 highest end time，则

注意

该情况可能由于编码帧移除算法会保留移除区间起始之前的编码帧而出现。
1. 将 new duration 更新为 highest end time。
将 duration 更新为 new duration。
使用必要时镜像算法，在 Window 上运行以下步骤以更新媒体元素的时长：
1. 将媒体元素的 duration 更新为 new duration。
2. 运行 HTMLMediaElement 时长变更算法。

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

将 readyState 属性值设置为 "ended"。
排队一个任务以触发事件 sourceended 到 MediaSource。
如果 error 未设置
1. 以所有 SourceBuffer（在 sourceBuffers 中）内所有轨道缓冲区的缓冲区范围最大结束时间为 new duration，运行时长变更算法。
  
  注意
  
  这样可使时长正确反映追加的媒体分段的结束。例如，若时长显式设置为10秒，实际只追加了0~5秒的媒体分段后调用了 endOfStream()，那么时长会被更新为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 上运行步骤，无论 MediaSource 是在同一个 Window 还是在 DedicatedWorkerGlobalScope 上绑定，通常用于更新绑定的 HTMLMediaElement 的状态。此算法接收一个 steps 参数，列出要在 Window 上执行的步骤。

如果 MediaSource 构造于 DedicatedWorkerGlobalScope：

向 [[port to main]] 发送内部 mirror on window 消息，其 Window 上的隐式处理程序将运行 steps。直接将控制权返回给调用者，无需等待该处理程序收到消息。

注意

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

steps 会作为其自己的任务在 Window 上异步运行，而不是在其他 Window 任务执行过程中间插入；
steps 的执行不会阻塞在 DedicatedWorkerGlobalScope 上该算法的同步运行与返回。

否则：

直接运行 steps。

MediaSourceHandle 接口表示 MediaSource 对象的代理，用于将 DedicatedWorkerGlobalScope 上的 MediaSource 通过 Window 上的 HTMLMediaElement 使用 srcObject 进行绑定，具体见绑定到媒体元素算法。

注意

为了能够跨上下文将 MediaSource 绑定到媒体元素，必须使用该独立对象，因为 MediaSource 本身不可传递（transferable），因其是事件目标。

每个 MediaSourceHandle 对象有一个 [[has ever been assigned as srcobject]] 内部槽，存储一个 boolean。该槽在 MediaSourceHandle 对象创建时初始化为 false，在扩展的 HTMLMediaElement 的 srcObject setter（见 10. HTMLMediaElement 扩展）中设置为 true，若为 true，则会阻止该 MediaSourceHandle 的成功传递，具体见 4.1 传递。

MediaSourceHandle 对象是 Transferable，每个对象有一个 [[Detached]] 内部槽，用于保证该实例在被传递后不可再次传递。

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

MediaSourceHandle 的传递步骤和传递接收步骤要求实现维护一个隐式内部槽，引用底层 MediaSource，以支持通过 srcObject 进行绑定到媒体元素，以及随之建立绑定的跨上下文通信模型。

注意

实现者应注意，Transferable 所暗示的“move”语义并不总是真实的。例如，postMessage 的扩展或内部广播实现可能导致被传递的 MediaSourceHandle 有多个接收方。因此，实现建议：只有当底层 MediaSource 的任一句柄在媒体元素资源选择算法的异步部分被使用时，才确定哪个潜在克隆仍然有效。这类似于通过 MediaSource 对象 URL 进行绑定的现有行为，该 URL 可被轻易克隆，但所有克隆最多只允许一次绑定启动。

实现必须保证底层 MediaSource 对象只能通过 srcObject 进行一次绑定（加载），不论 MediaSourceHandle 是否因 Transferable 的不同实现而被克隆。

注意

参考绑定到媒体元素，了解媒体元素资源选择算法的异步部分如何强制执行此要求。

MediaSourceHandle 仅暴露在 Window 和 DedicatedWorkerGlobalScope 上下文，且不能在不同 agent cluster [ECMASCRIPT] 间成功传递。MediaSourceHandle 对象只能在同一个 agent cluster 内传递成功。

注意

例如，将 MediaSourceHandle 对象从 Window 或 DedicatedWorkerGlobalScope 传递到 SharedWorker 或 ServiceWorker 都不会成功。开发者应了解该限制与 MediaSource 对象 URL 的不同，后者是可通过多种方式传递的 DOMString。即便如此，通过 MediaSource 对象 URL 进行绑定到媒体元素也只能用于构造于 Window 上下文的 MediaSource。另见 Web 应用 API 的 agent 和 agent cluster 形式化，[HTML] 中相关概念如 dedicated worker agents。

传递步骤对于 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 需要补充 DedicatedWorker 的 Exposed mse-in-workers

[HTML] AudioTrackList, VideoTrackList 和 TextTrackList 需要支持 Window+DedicatedWorker 暴露。

mode 类型 AppendMode

控制如何处理一系列媒体分段。该属性在对象创建后由 addSourceBuffer() 初始化，可通过 changeType() 或直接设置此属性进行更新。

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

设置时，执行如下步骤：

如果该对象已从 sourceBuffers（父媒体源）中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性为 true，则抛出 InvalidStateError 异常并终止这些步骤。
令 new mode 为分配的新值。
如果 [[generate timestamps flag]] 为 true 且 new mode 为 "segments"，则抛出 TypeError 异常并终止这些步骤。
如果父媒体源的 readyState 属性为 "ended"，则执行：
1. 将父媒体源的 readyState 属性设为 "open"
2. 排队一个任务以触发事件 sourceopen 到父媒体源。
如果 [[append state]] 为 PARSING_MEDIA_SEGMENT，则抛出 InvalidStateError 并终止这些步骤。
如果 new mode 为 "sequence"，则将 [[group start timestamp]] 设为 [[group end timestamp]]。
将该属性更新为 new mode。

updating 类型 boolean, 只读

指示 appendBuffer() 或 remove() 操作的异步处理是否仍在进行。该属性在对象创建时初始为 false。

buffered 类型 TimeRanges, 只读

指示本 SourceBuffer 已缓冲了哪些 TimeRanges。创建时初始值为空 TimeRanges 对象。

读取该属性时，需执行以下步骤必须：

如果该对象已从 sourceBuffers（父媒体源）中移除，则抛出 InvalidStateError 异常并终止这些步骤。
令 highest end time 为本对象管理的所有轨道缓冲区的缓冲区范围的最大结束时间。
令 intersection ranges 为一个 TimeRanges 对象，内容为从 0 到 highest end time 的单个区间。
对本对象管理的每个音频和视频轨道缓冲区，运行以下步骤：

注意

文本轨道缓冲区参与计算 highest end time，但本处缓冲区范围计算不包含文本轨道。文本轨道不一定连续，也不应因其不连续导致其他媒体轨道在同一区间连续时播放停顿。
1. 令 track ranges 为当前轨道缓冲区的缓冲区范围。
2. 如果 readyState 为 "ended"，则将 track ranges 最后一个区间的结束时间设为 highest end time。
3. 令 new intersection ranges 为 intersection ranges 与 track ranges 的交集。
4. 用 new intersection ranges 替换 intersection ranges 中的区间。
如果 intersection ranges 不包含与当前属性值完全一致的区间信息，则更新属性值为 intersection ranges。
返回当前属性值。

timestampOffset 类型 double

控制追加到本 SourceBuffer 的后续媒体分段内时间戳应用的偏移量。初始值为 0，表示不应用偏移。

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

设置时，执行如下步骤：

令 new timestamp offset 为分配的新值。
如果该对象已从 sourceBuffers（父媒体源）中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性为 true，则抛出 InvalidStateError 异常并终止这些步骤。
如果父媒体源的 readyState 属性为 "ended"，则执行：
1. 将父媒体源的 readyState 属性设为 "open"
2. 排队一个任务以触发事件 sourceopen 到父媒体源。
如果 [[append state]] 为 PARSING_MEDIA_SEGMENT，则抛出 InvalidStateError 并终止这些步骤。
如果 mode 属性为 "sequence"，则将 [[group start timestamp]] 设为 new timestamp offset。
将该属性更新为 new timestamp offset。

audioTracks 类型 AudioTrackList, 只读

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

videoTracks 类型 VideoTrackList, 只读

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

textTracks 类型 TextTrackList, 只读

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

appendWindowStart 类型 double

展示时间戳，用于表示追加窗口的起始。该属性初始设为展示起始时间。

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

设置时，执行如下步骤：

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

appendWindowEnd 类型 unrestricted double

展示时间戳，表示追加窗口的结束。该属性初始设为正无穷大。

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

设置时，执行如下步骤：

如果该对象已从 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。

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

运行准备追加算法。
将 data 添加到 [[input buffer]] 的末尾。
将 updating 属性设为 true。
排队一个任务以触发事件 updatestart 到本 SourceBuffer 对象。
异步运行缓冲区追加算法。

abort

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

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

如果该对象已从 sourceBuffers（父媒体源）中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果父媒体源的 readyState 属性不是 "open"，则抛出 InvalidStateError 异常并终止这些步骤。
如果区间移除算法正在运行，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性为 true，则运行以下步骤：
1. 若正在运行缓冲区追加算法，则中止该算法。
2. 将 updating 属性设为 false。
3. 排队一个任务以触发事件 abort 到本 SourceBuffer 对象。
4. 排队一个任务以触发事件 updateend 到本 SourceBuffer 对象。
运行重置解析器状态算法。
将 appendWindowStart 设为展示开始时间。
将 appendWindowEnd 设为正无穷。

changeType

更改该对象关联的 MIME 类型。后续的 appendBuffer() 调用会要求新追加的字节与新类型一致。

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

如果 type 为空字符串，则抛出 TypeError 异常并终止这些步骤。
如果该对象已从 sourceBuffers（父媒体源）中移除，则抛出 InvalidStateError 异常并终止这些步骤。
如果 updating 属性为 true，则抛出 InvalidStateError 异常并终止这些步骤。
如果 type 包含不支持的 MIME 类型，或与 SourceBuffer（在父媒体源的 sourceBuffers 属性中）当前或先前指定的类型不兼容，则抛出 NotSupportedError 异常并终止这些步骤。
如果父媒体源的 readyState 属性为 "ended"，则执行：
1. 将父媒体源的 readyState 属性设为 "open"。
2. 排队一个任务以触发事件 sourceopen 到父媒体源。
运行重置解析器状态算法。
根据字节流格式注册表 [MSE-REGISTRY] 中 type 对应条目的 "Generate Timestamps Flag" 列，为本 SourceBuffer 对象更新 [[generate timestamps flag]] 的值。
如果 [[generate timestamps flag]] 为 true：

将本 mode 属性设为 "sequence"，并运行属性被设置时的相关步骤。

否则：

保持本 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 时更新。

每个轨道缓冲区有一个上次解码时间戳变量，用于存储当前编码帧组中最后一个追加的编码帧的解码时间戳。该变量初始为未设置，表示还没有追加任何编码帧。

每个轨道缓冲区有一个最后帧时长变量，用于存储当前编码帧组中最后一个追加的编码帧时长。该变量初始为未设置，表示还没有追加任何编码帧。

每个轨道缓冲区有一个最大结束时间戳变量，用于存储当前编码帧组中追加到该轨道缓冲区的所有编码帧的最大编码帧结束时间戳。初始为未设置，表示还没有追加任何编码帧。

每个轨道缓冲区有一个需要随机访问点标志变量，用于标记轨道缓冲区是否在等待一个随机访问点编码帧。该变量初始为 true，表示需要随机访问点编码帧后才能向该轨道缓冲区添加内容。

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

注意

对于轨道缓冲区范围，这些展示时间区间基于展示时间戳、帧时长，以及多轨道缓冲区复用的 SourceBuffer 中各编码帧组可能的起始时间。

从规范角度看，这些信息视为存储在标准化 TimeRanges 对象中。交集轨道缓冲区范围用于报告 HTMLMediaElement 的 buffered，并必须支持在每个 HTMLMediaElement 的 buffered 区间内不间断播放。

注意

这些编码帧组起始时间与编码帧处理算法中提到的略有不同，实际为所有轨道缓冲区在不连续后最早的展示时间戳。不连续可在编码帧处理算法内出现，也可由编码帧移除算法导致，无论 mode 为何。轨道缓冲区范围判定不连续的阈值由实现决定。例如，为减少意外播放停顿，实现可以通过合并小于本轨道缓冲区已缓冲最大帧时长两倍的相邻区间，以近似编码帧处理算法的不连续检测逻辑。实现还可以在复用的 SourceBuffer 中跨轨道缓冲区使用编码帧组起始时间作为区间起点，以进一步减少意外播放停顿。

事件名	接口	何时派发...
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 对象有一个 [[append state]] 内部槽，用于记录高层分段解析状态。初始值为 WAITING_FOR_SEGMENT，追加数据时可转为以下状态。

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

每个 SourceBuffer 对象有一个 [[input buffer]] 内部槽，是个字节缓冲区，保存 appendBuffer() 调用之间未解析的字节。创建对象时该缓冲区为空。

每个 SourceBuffer 对象有一个 [[buffer full flag]] 内部槽，用于记录 appendBuffer() 是否允许接受更多字节。对象创建时设为 false，追加和移除数据时会更新。

每个 SourceBuffer 对象有一个 [[group start timestamp]] 内部槽，用于记录 "sequence" 模式下新编码帧组的起始时间戳。对象创建时未设置，mode 属性为 "sequence" 且 timestampOffset 属性被设置，或运行编码帧处理算法时会更新。

每个 SourceBuffer 对象有一个 [[group end timestamp]] 内部槽，存储当前编码帧组所有编码帧的最大编码帧结束时间戳。创建对象时设为 0，运行编码帧处理算法时更新。

注意

[[group end timestamp]] 记录的是编码帧结束时间戳在一个 SourceBuffer 的所有轨道缓冲区中的最大值。因此，在追加多轨道复用且时间戳未对齐分段时，需谨慎设置 mode 属性。

每个 SourceBuffer 对象有一个 [[generate timestamps flag]] 内部槽，是个布尔值，用于记录传给编码帧处理算法的编码帧是否需要生成时间戳。该标志由 addSourceBuffer() 创建对象时设置，changeType() 可更新。

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

循环顶部： 如果 [[input buffer]] 为空，则跳转到下方 需要更多数据 步骤。
如果 [[input buffer]] 包含违反 SourceBuffer 字节流格式规范的字节，则运行追加错误算法并终止本算法。
从 [[input buffer]] 的起始位置移除字节流格式规范要求必须忽略的字节。
如果 [[append state]] 为 WAITING_FOR_SEGMENT，则运行以下步骤：
1. 如果 [[input buffer]] 的起始位置表示初始化分段开始，则将 [[append state]] 设为 PARSING_INIT_SEGMENT。
2. 如果 [[input buffer]] 的起始位置表示媒体分段开始，则将 [[append state]] 设为 PARSING_MEDIA_SEGMENT。
3. 跳转到上方循环顶部步骤。
如果 [[append state]] 为 PARSING_INIT_SEGMENT，则运行以下步骤：
1. 如果 [[input buffer]] 尚未包含完整的初始化分段，则跳转到下方需要更多数据步骤。
2. 运行初始化分段接收算法。
3. 从 [[input buffer]] 起始移除初始化分段字节。
4. 将 [[append state]] 设为 WAITING_FOR_SEGMENT。
5. 跳转到上方循环顶部步骤。
如果 [[append state]] 为 PARSING_MEDIA_SEGMENT，则运行以下步骤：
1. 如果 [[first initialization segment received flag]] 为 false 或 [[pending initialization segment for changeType flag]] 为 true，则运行追加错误算法并终止本算法。
2. 如果 [[input buffer]] 包含一个或多个完整编码帧，则运行编码帧处理算法。
  
  注意
  
  编码帧处理算法运行频率由实现决定。其可以在输入缓冲区包含完整媒体分段时调用，也可以在完整编码帧加入输入缓冲区时多次调用。
3. 如果本 SourceBuffer 已满且无法接受更多媒体数据，则将 [[buffer full flag]] 设为 true。
4. 如果 [[input buffer]] 尚未包含完整的媒体分段，则跳转到下方需要更多数据步骤。
5. 从 [[input buffer]] 起始移除媒体分段字节。
6. 将 [[append state]] 设为 WAITING_FOR_SEGMENT。
7. 跳转到上方循环顶部步骤。
需要更多数据：将控制权返回给调用算法。

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

如果 [[append state]] 等于 PARSING_MEDIA_SEGMENT 并且 [[input buffer]] 包含一些完整的编码帧，则运行编码帧处理算法，直到所有这些完整的编码帧都被处理完毕。
取消所有轨道缓冲区上的最后解码时间戳。
取消所有轨道缓冲区上的最后帧持续时间。
取消所有轨道缓冲区上的最高结束时间戳。
将所有轨道缓冲区上的需要随机访问点标志设置为 true。
如果 mode 属性等于 "sequence"，则将 [[group start timestamp]] 设置为 [[group end timestamp]]
移除 [[input buffer]] 中的所有字节。
将 [[append state]] 设置为 WAITING_FOR_SEGMENT。

当追加过程中发生错误时调用此算法。

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

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

如果 SourceBuffer 已从 sourceBuffers 属性移除（属于父媒体源），则抛出 InvalidStateError 异常并中止这些步骤。
如果 updating 属性为 true，则抛出 InvalidStateError 异常并中止这些步骤。
让 recent element error 按如下方式确定：

如果 MediaSource 在 Window 中构造

如果 HTMLMediaElement 的 error 属性不为 null，则 recent element error 为 true。若属性为 null，则 recent element error 为 false。

否则

recent element error 的值为 Window 情况下的步骤结果，但需在 Window 上的 HTMLMediaElement 的 error 属性发生变化时，并通过 [[port to worker]] 隐式消息通知。如果尚未收到该消息，则 recent element error 为 false。
如果 recent element error 为 true，则抛出 InvalidStateError 异常并中止这些步骤。
如果 readyState 属性的父媒体源处于 "ended" 状态，则运行以下步骤：
1. 将 readyState 属性的父媒体源设置为 "open"
2. 排队一个任务以触发一个事件，事件名为 sourceopen，触发于父媒体源。
运行编码帧清除算法。
如果 [[buffer full flag]] 等于 true，则抛出 QuotaExceededError 异常并中止这些步骤。

注意

这是实现无法清除足够数据以容纳追加内容或追加内容过大的信号。Web 应用应当使用 remove() 显式释放空间和/或减少追加数据量。

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

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

当调用者需要发起一个 JavaScript 可见的范围移除操作（该操作会阻塞其它 SourceBuffer 更新）时，按照以下步骤进行：

令 start 等于移除范围的起始展示时间戳，单位为从展示起始时间开始计的秒数。
令 end 等于移除范围的结束展示时间戳，单位为从展示起始时间开始计的秒数。
将 updating 属性设为 true。
排队一个任务以触发名为 updatestart 的事件，在此 SourceBuffer 对象上。
将控制权返回给调用方，并异步执行剩下的步骤。
运行编码帧移除算法，start 和 end 分别作为移除范围的起止。
将 updating 属性设为 false。
排队一个任务以触发名为 update 的事件，在此 SourceBuffer 对象上。
排队一个任务以触发名为 updateend 的事件，在此 SourceBuffer 对象上。

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

每个 SourceBuffer 对象都有一个用于跟踪是否已经由该算法追加并接收到首个初始化分段的内部插槽 [[first initialization segment received flag]]。该标志在创建 SourceBuffer 时被设为 false，并由下述算法进行更新。

每个 SourceBuffer 对象都有一个用于跟踪自最近一次 changeType() 起是否需要初始化分段的内部插槽 [[pending initialization segment for changeType flag]]。该标志在创建 SourceBuffer 时设为 false，由 changeType() 设为 true，并由下述算法重置为 false。

如果当前 duration 属性值为 NaN，则进行更新：

如果初始化分段包含一个时长：

运行时长变更算法，并将 new duration 设为初始化分段中的该时长。

否则：

运行时长变更算法，并将 new duration 设为正无穷大。
如果该初始化分段不包含音频、视频或文本轨，则运行追加错误算法并中止这些步骤。
如果 [[first initialization segment received flag]] 为 true，则运行以下步骤：
1. 验证下列属性。如有任一检查失败，则运行追加错误算法并中止这些步骤。
  - 音频、视频与文本轨的数量与首个初始化分段中的一致。
  - 如果单一类型存在多条轨（例如 2 条音轨），则这些轨的 Track ID 与首个初始化分段中的一致。
  - 每条轨的编解码器均受用户代理支持。
    
    注意
    
    如果某些编解码器未在最近一次成功的 changeType() 调用中传入的 type 参数（a），或者（b）若此对象尚未进行过成功的 changeType()，则为创建该 SourceBuffer 对象的 addSourceBuffer() 中被指定，用户代理 MAY 将本应受支持的编解码器视为此处“不受支持”。例如，如果最近一次成功的 changeType() 使用了 'video/webm' 或 'video/webm; codecs="vp8"'，而初始化分段中出现了包含 vp9 的视频轨，则即便上述另外两项检查通过，用户代理也 MAY 利用此步骤触发解码错误。鼓励实现仅在该编解码器确实不受支持或另外两项检查失败时触发错误。鼓励 Web 作者使用带有精确编解码器参数的 changeType()、 addSourceBuffer() 和 isTypeSupported() 更主动地检测用户代理支持情况。当 SourceBuffer 对象的字节流格式发生变化时，必须调用 changeType()。
2. 将该初始化分段中相应的轨道描述添加到各个轨道缓冲区。
3. 将所有轨道缓冲区上的 need random access point flag 设为 true。
令 active track flag 等于 false。
如果 [[first initialization segment received flag]] 为 false，则运行以下步骤：
1. 如果该初始化分段包含用户代理不支持的编解码器的轨，则运行追加错误算法并中止这些步骤。
  
  注意
  
  如果某些编解码器未在最近一次成功的 changeType() （a）调用传入的 type 参数中指定，或者（b）若此对象尚未发生成功的 changeType()，则为创建该对象的 addSourceBuffer() 中指定，用户代理 MAY 将本应受支持的编解码器视为“不受支持”，从而触发解码错误。例如， MediaSource.isTypeSupported('video/webm;codecs="vp8,vorbis"') 可能返回 true，但如果 addSourceBuffer() 被调用时使用了 'video/webm;codecs="vp8"'，而初始化分段中出现了 Vorbis 轨，则用户代理 MAY 使用此步骤触发解码错误。鼓励实现仅在编解码器确实不受支持时触发错误。鼓励 Web 作者使用带有精确编解码器参数的 changeType()、 addSourceBuffer() 和 isTypeSupported() 更主动地检测用户代理支持情况。当 changeType() 为 SourceBuffer 对象更改字节流格式时是必需的。
2. 对于该初始化分段中的每条音轨，运行以下步骤：
  1. 令 audio byte stream track ID 为当前待处理音轨的 Track ID。
  2. 令 audio language 为该轨在初始化分段中指定的 BCP 47 语言标记；若无语言信息，则为一个空字符串。
  3. 如果 audio language 等于 BCP 47 的 'und' 值，则将 audio language 设为空字符串。
  4. 令 audio label 为该轨在初始化分段中指定的标签；若无标签信息，则为空字符串。
  5. 令 audio kinds 为该轨在初始化分段中指定的一组 kind 字符串；若未提供 kind 信息，则为仅包含一个空字符串的序列。
  6. 对于 audio kinds 中的每个值，运行以下步骤：
    1. 令 current audio kind 等于本次循环中来自 audio kinds 的该值。
    2. 令 new audio track 为一个新的 AudioTrack 对象。
    3. 生成一个唯一 ID，并将其赋值给 new audio track 的 id 属性。
    4. 将 audio language 赋值给 new audio track 的 language 属性。
    5. 将 audio label 赋值给 new audio track 的 label 属性。
    6. 将 current audio kind 赋值给 new audio track 的 kind 属性。
    7. 如果该 SourceBuffer 对象的 audioTracks 的 length 等于 0，则运行以下步骤：
      1. 将 new audio track 的 enabled 属性设为 true。
      2. 将 active track flag 设为 true。
    8. 将 new audio track 添加到该 audioTracks 属性中，位于此 SourceBuffer 对象上。
      
      注意
      
      这应当触发 AudioTrackList [HTML] 逻辑，排队一个任务以触发一个事件，事件名为 addtrack，并使用 TrackEvent，其 track 属性初始化为 new audio track，触发于由该 audioTracks 属性引用的 AudioTrackList 对象上，此对象位于该 SourceBuffer 上。
    9. 如果父媒体源是在 DedicatedWorkerGlobalScope 中构造的：
      
      向 [[port to main]] 发送一条内部 create track mirror 消息，其在 Window 中的隐式处理器运行以下步骤：
      
      令 mirrored audio track 为一个新的 AudioTrack 对象。
      
      将与 new audio track 确定的相同属性值赋予 mirrored audio track。
      
      将 mirrored audio track 添加到 HTMLMediaElement 的 audioTracks 属性中。
      
      否则：
      
      将 new audio track 添加到 HTMLMediaElement 的 audioTracks 属性中。
      注意
      
      这应当触发 AudioTrackList [HTML] 逻辑，排队一个任务以触发一个事件，事件名为 addtrack，并使用 TrackEvent，其 track 属性初始化为 mirrored audio track 或 new audio track，触发于由 HTMLMediaElement 的 audioTracks 属性引用的 AudioTrackList 对象上。
  7. 创建一个新的轨道缓冲区，用于为该轨存储编码帧。
  8. 将该轨的轨道描述添加到该轨道缓冲区中。
3. 对于该初始化分段中的每条视频轨，运行以下步骤：
  1. 令 video byte stream track ID 为当前待处理视频轨的 Track ID。
  2. 令 video language 为该轨在初始化分段中指定的 BCP 47 语言标记；若无语言信息，则为空字符串。
  3. 如果 video language 等于 BCP 47 的 'und' 值，则将 video language 设为空字符串。
  4. 令 video label 为该轨在初始化分段中指定的标签；若无标签信息，则为空字符串。
  5. 令 video kinds 为该轨在初始化分段中指定的一组 kind 字符串；若未提供 kind 信息，则为仅包含一个空字符串的序列。
  6. 对于 video kinds 中的每个值，运行以下步骤：
    1. 令 current video kind 等于本次循环中来自 video kinds 的该值。
    2. 令 new video track 为一个新的 VideoTrack 对象。
    3. 生成一个唯一 ID，并将其赋值给 new video track 的 id 属性。
    4. 将 video language 赋值给 new video track 的 language 属性。
    5. 将 video label 赋值给 new video track 的 label 属性。
    6. 将 current video kind 赋值给 new video track 的 kind 属性。
    7. 如果该 SourceBuffer 对象的 videoTracks 的 length 等于 0，则运行以下步骤：
      1. 将 new video track 的 selected 属性设为 true。
      2. 将 active track flag 设为 true。
    8. 将 new video track 添加到该 videoTracks 属性中，位于此 SourceBuffer 对象上。
      
      注意
      
      这应当触发 VideoTrackList [HTML] 逻辑，排队一个任务以触发一个事件，事件名为 addtrack，并使用 TrackEvent，其 track 属性初始化为 new video track，触发于由该 videoTracks 属性引用的 VideoTrackList 对象上，此对象位于该 SourceBuffer 上。
    9. 如果父媒体源是在 DedicatedWorkerGlobalScope 中构造的：
      
      向 [[port to main]] 发送一条内部 create track mirror 消息，其在 Window 中的隐式处理器运行以下步骤：
      
      令 mirrored video track 为一个新的 VideoTrack 对象。
      
      将与 new video track 确定的相同属性值赋予 mirrored video track。
      
      将 mirrored video track 添加到 HTMLMediaElement 的 videoTracks 属性中。
      
      否则：
      
      将 new video track 添加到 HTMLMediaElement 的 videoTracks 属性中。
      注意
      
      这应当触发 VideoTrackList [HTML] 逻辑，排队一个任务以触发一个事件，事件名为 addtrack，并使用 TrackEvent，其 track 属性初始化为 mirrored video track 或 new video track，触发于由 HTMLMediaElement 的 videoTracks 属性引用的 VideoTrackList 对象上。
  7. 创建一个新的轨道缓冲区，用于为该轨存储编码帧。
  8. 将该轨的轨道描述添加到该轨道缓冲区中。
4. 对于该初始化分段中的每条文本轨，运行以下步骤：
  1. 令 text byte stream track ID 为当前待处理文本轨的 Track ID。
  2. 令 text language 为该轨在初始化分段中指定的 BCP 47 语言标记；若无语言信息，则为空字符串。
  3. 如果 text language 等于 BCP 47 的 'und' 值，则将 text language 设为空字符串。
  4. 令 text label 为该轨在初始化分段中指定的标签；若无标签信息，则为空字符串。
  5. 令 text kinds 为该轨在初始化分段中指定的一组 kind 字符串；若未提供 kind 信息，则为仅包含一个空字符串的序列。
  6. 对于 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 添加到该 textTracks 属性中，位于此 SourceBuffer 对象上。
      
      注意
      
      这应当触发 TextTrackList [HTML] 逻辑，排队一个任务以触发一个事件，事件名为 addtrack，并使用 TrackEvent，其 track 属性初始化为 new text track，触发于由该 textTracks 属性引用的 TextTrackList 对象上，此对象位于该 SourceBuffer 上。
    10. 如果父媒体源是在 DedicatedWorkerGlobalScope 中构造的：
      
      向 [[port to main]] 发送一条内部 create track mirror 消息，其在 Window 中的隐式处理器运行以下步骤：
      
      令 mirrored text track 为一个新的 TextTrack 对象。
      
      将与 new text track 确定的相同属性值赋予 mirrored text track。
      
      将 mirrored text track 添加到 HTMLMediaElement 的 textTracks 属性中。
      
      否则：
      
      将 new text track 添加到 HTMLMediaElement 的 textTracks 属性中。
      注意
      
      这应当触发 TextTrackList [HTML] 逻辑，排队一个任务以触发一个事件，事件名为 addtrack，并使用 TrackEvent，其 track 属性初始化为 mirrored text track 或 new text track，触发于由 HTMLMediaElement 的 textTracks 属性引用的 TextTrackList 对象上。
  7. 创建一个新的轨道缓冲区，用于为该轨存储编码帧。
  8. 将该轨的轨道描述添加到该轨道缓冲区中。
5. 如果 active track flag 等于 true，则运行以下步骤：
  1. 将该 SourceBuffer 添加到 activeSourceBuffers。
  2. 排队一个任务以触发一个事件，事件名为 addsourcebuffer，触发于 activeSourceBuffers
6. 将 [[first initialization segment received flag]] 设为 true。
将 [[pending initialization segment for changeType flag]] 设为 false。
如果 active track flag 等于 true，则运行以下步骤：
使用父媒体源的必要时镜像算法在 Window 中运行以下步骤：
1. 如果 HTMLMediaElement 的 readyState 属性大于 HAVE_CURRENT_DATA，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_METADATA。
  
  注意
  
  根据 HTMLMediaElement ready states [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在 HTMLMediaElement 上触发事件。
如果 sourceBuffers 中的每个对象（属于父媒体源）的 [[first initialization segment received flag]] 都为 true，则使用父媒体源的必要时镜像算法在 Window 中运行以下步骤：
1. 如果 HTMLMediaElement 的 readyState 属性为 HAVE_NOTHING，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_METADATA。
  
  注意
  
  根据 HTMLMediaElement ready states [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 小于最后解码时间戳：
  
  或
  
  如果最后解码时间戳（属于 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，则执行以下步骤：
  1. 如果该编码帧不是一个随机访问点，则丢弃该编码帧，并跳转到循环顶部开始处理下一帧编码帧。
  2. 将 track buffer 上的需要随机访问点标志设为 false。
11. 令 spliced audio frame 为一个未设值的变量，用于保存音频拼接信息。
12. 令 spliced timed text frame 为一个未设值的变量，用于保存定时文本拼接信息。
13. 如果最后解码时间戳（属于 track buffer）未设置，且 presentation timestamp 落在展示区间内（此区间属于编码帧）且该编码帧位于 track buffer 中，则执行以下步骤：
  1. 令 overlapped frame 为 track buffer 中满足上述条件的编码帧。
  2. 如果 track buffer 包含音频编码帧：
    
    运行音频拼接帧算法，若返回了拼接帧，则将其赋给 spliced audio frame。
    
    如果 track buffer 包含视频编码帧：
    令 remove window timestamp 等于 overlapped frame 的展示时间戳加 1 微秒。
    
    如果 presentation timestamp 小于 remove window timestamp，则从 track buffer 移除 overlapped frame。
    
    注意
    
    这是为了补偿在双精度浮点与有理数之间往返转换时可能出现的帧时间戳计算的微小误差。该容差允许在新帧的起始时间与已存在帧的起始时间相差不超过 1 微秒时，用新帧替换已存在帧。稍早于已存在帧到来的帧将由下方的移除步骤处理。
    如果 track buffer 包含定时文本编码帧：
    
    运行文本拼接帧算法，若返回了拼接帧，则将其赋给 spliced timed text frame。
14. 移除 track buffer 中已有的编码帧：
  
  如果最高结束时间戳（属于 track buffer）未设置：
  
  从 track buffer 中移除所有编码帧，这些帧的展示时间戳大于等于 presentation timestamp 且小于 frame end timestamp。
  
  如果最高结束时间戳（属于 track buffer）已设置且小于等于 presentation timestamp：
  
  从 track buffer 中移除所有编码帧，这些帧的展示时间戳大于等于最高结束时间戳且小于 frame end timestamp。
15. 通过移除在前两个步骤中被移除的编码帧的所有可能解码依赖来清理依赖关系：从 track buffer 中移除位于上述已移除帧与这些帧之后的下一个随机访问点之间的所有编码帧。
  
  注意
  
  一直移除到下一个随机访问点是对解码依赖的保守估计，因为这假设在被移除帧与下一个随机访问点之间的所有帧都依赖于已被移除的那些帧。
16. 如果 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。
17. 将 track buffer 的最后解码时间戳设为 decode timestamp。
18. 将 track buffer 的最后帧持续时间设为 frame duration。
19. 如果最高结束时间戳（属于 track buffer）未设置，或 frame end timestamp 大于最高结束时间戳，则将最高结束时间戳（属于 track buffer）设为 frame end timestamp。
  
  注意
  
  需要“大于”检查，因为编码帧之间的双向预测可能导致 presentation timestamp 不是单调递增的，即使解码时间戳是单调递增的。
20. 如果 frame end timestamp 大于 [[group end timestamp]]，则将 [[group end timestamp]] 设为 frame end timestamp。
21. 如果 [[generate timestamps flag]] 等于 true，则将 timestampOffset 设为 frame end timestamp。
如果 HTMLMediaElement 的 readyState 属性为 HAVE_METADATA 且新的编码帧使 HTMLMediaElement 的 buffered 在当前播放位置拥有一个 TimeRanges，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_CURRENT_DATA。

注意

根据 HTMLMediaElement ready states [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能在该元素上触发事件。
如果 HTMLMediaElement 的 readyState 属性为 HAVE_CURRENT_DATA 且新的编码帧使 HTMLMediaElement 的 buffered 拥有一个 TimeRanges，该 TimeRanges 覆盖当前播放位置并延伸至当前播放位置之后一段时间，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_FUTURE_DATA。

注意

根据 HTMLMediaElement ready states [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能在该元素上触发事件。
如果 HTMLMediaElement 的 readyState 属性为 HAVE_FUTURE_DATA 且新的编码帧使 HTMLMediaElement 的 buffered 拥有一个 TimeRanges，该 TimeRanges 覆盖当前播放位置并具有足够数据以确保不间断播放，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_ENOUGH_DATA。

注意

根据 HTMLMediaElement ready states [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能在该元素上触发事件。
如果该媒体分段包含超出当前 duration 的数据，则运行时长变更算法，并将 new duration 设为当前时长与 [[group end timestamp]] 的最大值。

当需要从 SourceBuffer 移除特定时间范围的编码帧时，请按照以下步骤操作：

令 start 为移除范围的起始展示时间戳。
令 end 为移除范围的结束展示时间戳。
对该 SourceBuffer 中的每个轨道缓冲区，运行以下步骤：
1. 令 remove end timestamp 为当前 duration 的值。
2. 如果此轨道缓冲区有一个大于等于 end 的随机访问点时间戳，则将 remove end timestamp 更新为该随机访问点时间戳。
  
  注意
  
  不同轨道的随机访问点时间戳可能不同，因为同一轨道内编码帧的依赖关系通常不同于另一轨道内的依赖关系。
3. 从该轨道缓冲区中移除所有起始时间戳大于等于 start 且小于 remove end timestamp 的媒体数据。
  1. 对每个被移除的帧，如果该帧的解码时间戳等于该帧轨道的最后解码时间戳，则运行以下步骤：
    
    如果 mode 等于 "segments"：
    
    将 [[group end timestamp]] 设置为展示时间戳。
    
    如果 mode 等于 "sequence"：
    
    将 [[group start timestamp]] 设置为 [[group end timestamp]] 的值。
  2. 取消所有轨道缓冲区上的最后解码时间戳。
  3. 取消所有轨道缓冲区上的最后帧持续时间。
  4. 取消所有轨道缓冲区上的最高结束时间戳。
  5. 将所有轨道缓冲区上的需要随机访问点标志设置为 true。
4. 通过移除在上一步中被移除的编码帧的所有可能解码依赖来清理依赖关系：从该轨道缓冲区中移除位于上述已移除帧与其后的下一个随机访问点之间的所有编码帧。
  
  注意
  
  一直移除到下一个随机访问点，是对解码依赖的保守估计，因为这假设在被移除帧与下一个随机访问点之间的所有帧都依赖于已被移除的那些帧。
5. 如果此对象在 activeSourceBuffers 中，当前播放位置大于等于 start 且小于 remove end timestamp，并且 HTMLMediaElement 的 readyState 大于 HAVE_METADATA，则将 HTMLMediaElement 的 readyState 属性设为 HAVE_METADATA，并暂停播放。
  
  注意
  
  根据 HTMLMediaElement ready states [HTML] 逻辑，HTMLMediaElement 的 readyState 变化可能会在该元素上触发事件。
  
  注意
  
  此状态变化发生是因为当前播放位置的媒体数据被移除了。只有在为当前播放位置追加了媒体数据，或发生了 3.15.5 选中/启用轨道状态变化，播放才能继续。
如果 [[buffer full flag]] 等于 true 且此对象已准备好接受更多字节，则将 [[buffer full flag]] 设为 false。

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

令 new data 为即将追加到此 SourceBuffer 的数据。

Issue 289: 编辑？编码帧清除算法需要注意“缓冲区满标志”可能会根据 |new data| 立即更新

需要在此处认识到，实现可以决定在预测处理 [[input buffer]] 中现有字节和 new data 后会超出 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 的编码帧。
将 presentation timestamp 和 decode timestamp 更新为基于 overlapped frame 音频采样率最近的音频采样时间戳。如果时间戳距离两个采样时间戳等距，则用较大的时间戳（例如， 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)
如果用户代理不支持淡入淡出，则运行以下步骤：
1. 从 track buffer 移除 overlapped frame。
2. 向 track buffer 添加一个静音帧，属性如下：
  - 展示时间戳设为 overlapped frame 的展示时间戳。
  - 解码时间戳设为 overlapped frame 的解码时间戳。
  - 编码帧时长设为 presentation timestamp 与 overlapped frame 的展示时间戳的差值。
  注意
  
  一些实现可以对插入静音帧两侧的编码帧应用淡入淡出处理，使过渡不那么突兀。
3. 无需返回拼接帧，直接返回给调用方。
  
  注意
  
  这样可使 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 加五毫秒。
令 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 没有共同的采样率和声道布局，则将其转换为统一的采样率和声道布局。
令 output samples 为用于存放输出采样的缓冲区。
对 fade out samples 中 splice timestamp 到 splice end timestamp 的采样应用线性增益淡出，起始增益为 1，结束增益为 0。
对 fade in samples 中 splice timestamp 到 splice end timestamp 的采样应用线性增益淡入，起始增益为 0，结束增益为 1。
将 fade out samples 中 presentation timestamp 到 splice timestamp 之间的采样复制到 output samples。
对 splice timestamp 到 splice end timestamp 之间的每个采样，计算 fade out samples 与 fade in samples 的相应采样之和，并存储到 output samples。
将 fade in samples 中 splice end timestamp 到 end timestamp 之间的采样复制到 output samples。
渲染 output samples。

注意

以下是该算法的图示。

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

令 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 对象。

事件名	接口	何时分发...
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

获取时：

返回该属性的当前值。

事件名	接口	何时分发...
startstreaming	`Event`	当 `ManagedMediaSource` 的 `streaming` 属性从 `false` 变为 `true` 时。
endstreaming	`Event`	当 `ManagedMediaSource` 的 `streaming` 属性从 `true` 变为 `false` 时。

以下步骤会周期性运行，每当 SourceBuffer 监控算法被调度执行时。

拥有足够的受管数据以确保不间断播放，是一个由实现定义的条件，用户代理判断当前拥有足够数据以在展示过程中避免长时间卡顿。该条件会被持续评估，以决定何时切换 streaming 的值。这些切换表示用户代理认为数据缓冲充足或仍需更多数据。

能以高效方式检索和缓冲数据，是一个由实现定义的条件，用户代理判断其能以节能的方式抓取新数据，同时实现所需内存使用。

运行 MediaSource 的 SourceBuffer 监控算法。
令 can play uninterrupted and efficiently 为一个标志，当下列条件同时满足时为 true： buffered 属性包含一个 TimeRanges，覆盖当前播放位置且拥有足够的受管数据以确保不间断播放，并且能以高效方式检索和缓冲数据
如果 can play uninterrupted and efficiently 不等于 streaming，在媒体元素上排队一个元素任务，其运行以下步骤：
1. 将 this 的 streaming 属性设为 can play uninterrupted and efficiently。
2. 如果 can play uninterrupted and efficiently 为 false，触发事件名为 startstreaming，于 ManagedMediaSource 处触发。
3. 否则，触发事件名为 endstreaming，于 ManagedMediaSource 处触发。

对 this 的 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。

事件名	接口	何时分发…
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 字典，并用 added 初始化其 addedRanges，用 removed 初始化其 removedRanges。
排队一个任务，以触发一个事件，事件名为 bufferedchange，在 buffer 上使用 BufferedChangeEvent 接口，并用 eventInitDict 初始化。

如果 this 不在其 ManagedMediaSource 父对象的 activeSourceBuffers 中：
1. 运行编码帧移除算法，将 start 设为 0，end 设为正无穷大，然后中止这些步骤。
令 removal ranges 为一组可从展示中被驱逐的展示时间范围，以确保从 currentTime 起直到能够再次获取该展示内容期间的连续播放。

注意

不同实现可以采用不同策略选择 removal ranges，因此 Web 应用不应依赖特定行为。Web 应用应监听 bufferedchange 事件以观察缓冲数据的部分是否被驱逐。
对于 removal ranges 中的每个范围，运行编码帧移除算法，其中 start 与 end 分别等于该移除范围的起始与结束时间戳。

本节规定当一个 MediaSource 附加到元素时，现有 HTMLMediaElement 的 seekable 与 HTMLMediaElement 的 buffered 属性必须返回的内容，以及当其 srcObject 属性被设为 MediaSourceHandle 对象时，现有 HTMLMediaElement 的 srcObject 属性必须执行的操作。

HTMLMediaElement 的 seekable 属性返回一个新的静态规范化 TimeRanges 对象，按以下步骤创建：

如果该 MediaSource 是在一个已终止或正在关闭的 DedicatedWorkerGlobalScope 中构造的，则返回一个空的 TimeRanges 对象并中止这些步骤。

注意

此情况旨在处理如下实现：当某个在 DedicatedWorkerGlobalScope 中构造的 MediaSource 因 terminate() 或用户代理执行终止 worker 而结束时，实现可能不再保留任何关于该 MediaSource 的已缓冲或可寻址媒体的历史信息；例如，这也可能是 close() 执行的最终结果。

Issue 277: MSE-in-Workers：在 MediaSource 的 worker 终止时，是否（最终）应让附加的元素进入错误状态/媒体元素应如何处理？mse-in-workers

当所附加的 worker 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 分别设为最近的取值，这些取值由该 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 对象并中止这些步骤。

注意

此情况旨在处理如下实现：当一个在 DedicatedWorkerGlobalScope 中构造的 MediaSource 因 terminate() 或用户代理执行终止 worker 而结束时，实现可能不再保留任何关于该 MediaSource 的已缓冲或可寻址媒体的历史信息；例如，这也可能是 close() 执行的最终结果。

Issue 277: MSE-in-Workers：在 MediaSource 的 worker 终止时，是否（最终）应让附加的元素进入错误状态/媒体元素应如何处理？mse-in-workers

当所附加的 worker 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 为对 buffered 的返回结果，针对 SourceBuffer 的每个对象，这些对象位于 activeSourceBuffers 中。
  2. 令 highest end time 为 active ranges 中最大的范围结束时间。
  3. 令 recent intersection ranges 为一个 TimeRanges 对象，其包含从 0 到 highest end time 的单一范围。
  4. 对于 SourceBuffer 中的每个对象（位于 activeSourceBuffers 中），运行以下步骤：
    
    令 source ranges 等于当前 buffered 属性返回的范围集合。
    
    若 readyState 为 "ended"，则将 source ranges 中最后一个范围的结束时间设为 highest end time。
    
    令 new intersection ranges 为 recent intersection ranges 与 source ranges 的交集。
    
    用 new intersection ranges 替换 recent intersection ranges 中的范围。
否则：

令 recent intersection ranges 为在 Window 情况下步骤所得的 TimeRanges，但使用位于其 DedicatedWorkerGlobalScope 中的该 MediaSource 及其 SourceBuffer 对象，并在每次更新 activeSourceBuffers、 readyState 或任何会改变各 buffered 属性取值的缓冲状态时，通过 [[port to main]] 的隐式消息进行通信。

注意

如此频繁地重新计算并通信 recent intersection ranges 会带来额外开销，这也是允许实现使用其他机制（如共享内存与锁）按需查询该信息的原因之一，详见跨上下文通信模型。
如果本算法尚未设置该属性的当前值，或 recent intersection ranges 不包含与该属性当前值完全相同的范围信息，则将该属性的当前值更新为 recent intersection ranges。
返回该属性的当前值。

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

注意

这可防止再次传输该 MediaSourceHandle 对象，并在尝试时提供明确的同步异常。

Issue

需要将 MediaSourceHandle 添加到 HTMLMediaElement 的 MediaProvider IDL typedef 及其与媒体提供者对象相关的文本中。

本节对 [HTML] 中 AudioTrack 的定义进行扩展。

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

Issue 280: MSE-in-Workers: {Audio,Video,Text}Track{,List} 在 HTML 中的 IDL 需要在 Exposed 中增加 DedicatedWorker mse-in-workers

[HTML] 中的 AudioTrack 需要同时对 Window 与 DedicatedWorker 暴露。

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

获取时，运行以下步骤：

如果此轨道是由与该轨道处于同一 realm 中创建的 SourceBuffer 所创建，且该 SourceBuffer 尚未从其 sourceBuffers 属性（属于其父媒体源）中被移除：: 返回创建此轨道的 SourceBuffer。
否则：: 返回 null。

注意

例如，若某个 DedicatedWorkerGlobalScope 的 SourceBuffer 通知其在 Window 中的内部 create track mirror 处理器创建了此轨道，则该轨道在 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} 在 HTML 中的 IDL 需要在 Exposed 中增加 DedicatedWorker 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} 在 HTML 中的 IDL 需要在 Exposed 中增加 DedicatedWorker mse-in-workers

[HTML] 中的 TextTrack 需要同时对 Window 与 DedicatedWorker 暴露。

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

获取时，运行以下步骤：

如果此轨道是由与该轨道处于同一 realm 中创建的 SourceBuffer 所创建，且该 SourceBuffer 尚未从其 sourceBuffers 属性（属于其父媒体源）中被移除：: 返回创建此轨道的 SourceBuffer。
否则：: 返回 null。

注意

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

注意

注册表中的字节流格式规范并不意在定义新的存储格式。它们仅概述了本规范实现所接受的既有存储格式结构的子集。

注意

字节流格式的解析与校验由分段解析循环算法实现。

本节为所有字节流格式规范提供通用要求：

字节流格式规范必须定义初始化分段与媒体分段。
字节流格式应当提供从初始化分段数据中引用 AudioTrack、 VideoTrack 与 TextTrack 属性值的映射参考。

注意

若某字节流格式涵盖的格式与带内轨道规范 [INBANDTRACKS] 所覆盖的某种格式相似，则其应当力求使用相同的属性映射，以便使用与不使用 Media Source Extensions 的播放能提供相同的轨道信息。
必须仅通过检查字节流本身即可识别分段边界与分段类型（初始化或媒体）。
当满足以下任一条件时，用户代理必须运行追加错误算法：
1. 轨道的数量与类型不一致。
  
  注意
  
  例如，若首个初始化分段包含 2 条音轨与 1 条视频轨，则其后字节流中的所有初始化分段必须描述 2 条音轨与 1 条视频轨。
2. Track ID 在多个同类型轨道（例如 2 条音轨）的不同初始化分段间不一致。
3. 不受支持的编解码器变更出现在不同的初始化分段之间。
  
  注意
  
  参见接收到初始化分段算法、 addSourceBuffer() 与 changeType() 以了解编解码器变更的细节与示例。
用户代理必须支持以下内容：
1. Track ID 在不同初始化分段间发生变化，前提是每种类型仅有一条轨道。
2. 视频帧尺寸变化。用户代理必须支持无缝播放。
  
  注意
  
  如果网页未通过 CSS 或 HTML（width/height）限制元素大小，这将导致 <video> 的显示区域尺寸发生变化。
3. 音频声道数变化。用户代理可以无缝支持，并可能触发下混。
  
  注意
  
  这是实现质量问题，因为更改声道数可能需要重新初始化音频设备、重采样器与声道混合器，往往会被听到。
以下规则适用于字节流中的所有媒体分段。用户代理必须：
1. 将所有时间戳映射到同一媒体时间线。
2. 支持时间戳间隙小于音频帧大小的媒体分段的无缝播放。用户代理不得在 buffered 属性中反映这些间隙。
  
  注意
  
  旨在简化在音频流之间切换的情形，此时不同编码的帧边界并不总是对齐（例如 Vorbis）。
当某个初始化分段与任何一段连续的媒体分段的任意组合满足如下条件时，用户代理必须运行追加错误算法：
1. 无法识别媒体分段中所有轨道的数量与类型（音频、视频、文本等）。
2. 未提供解码每条轨道所需的解码能力（即编解码器及其参数）。
3. 对于所有加密轨道，未提供解密内容所需的加密参数（加密密钥本身除外）。
4. 未提供用于解码与呈现该连续媒体分段中最早的随机访问点以及后续（按呈现时间顺序）样本所需的全部信息。具体包括：
  - 用于确定视频的固有宽度与高度的信息（具体而言，需要图片或像素纵横比与编码分辨率）。
  - 将视频解码器输出转换为可显示格式所需的信息
5. 未提供计算该连续媒体分段中每个样本的全局呈现时间戳所需的信息。
例如，若 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) {
      // 获取初始化分段出错。使用错误结束流。
      mediaSource.endOfStream("network");
      return;
    }

    // 追加初始化分段。
    sourceBuffer.addEventListener("updateend", function firstAppendHandler() {
      sourceBuffer.removeEventListener("updateend", firstAppendHandler);

      // 追加一些初始媒体数据。
      appendNextMediaSegment(mediaSource);
    });

    sourceBuffer.appendBuffer(initSegment);
  } catch (error) {
    // 处理在获取初始化分段期间可能发生的错误。
    console.error("获取初始化分段出错：", error);
    mediaSource.endOfStream("network");
  }
}

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

  // 若流数据已用尽，则结束流。
  if (!haveMoreMediaSegments()) {
    mediaSource.endOfStream();
    return;
  }

  try {
    const mediaSegment = await getNextMediaSegment();

    // 注意: 若 mediaSource.readyState == "ended"，此 appendBuffer() 调用将
    // 使其状态转为 "open"。Web 应用应准备处理多个 "sourceopen" 事件。
    mediaSource.sourceBuffers[0].appendBuffer(mediaSegment);
  }
  catch (error) {
    // 处理在获取媒体分段期间可能发生的错误。
    console.error("获取媒体分段出错：", error);
    mediaSource.endOfStream("network");
  }
}

function onSeeking(mediaSource, video) {
  if (mediaSource.readyState === "open") {
    // 中止当前分段追加。
    mediaSource.sourceBuffers[0].abort();
  }

  // 通知媒体分段加载逻辑从新的播放位置开始抓取数据。
  seekToMediaSegmentAt(video.currentTime);

  // 从新的播放位置追加一个媒体分段。
  appendNextMediaSegment(mediaSource);
}

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

// 获取初始化分段的异步函数示例
async function getInitializationSegment() {
  // 在此实现获取初始化分段的逻辑
  // 这里只是占位函数
}

// 检查是否还有更多媒体分段的示例函数
function haveMoreMediaSegments() {
  // 在此实现是否仍有更多媒体分段的判断逻辑
  // 这里只是占位函数
}

// 获取下一个媒体分段的示例函数
async function getNextMediaSegment() {
  // 在此实现获取下一个媒体分段的逻辑
  // 这里只是占位函数
}

// 跳转到特定媒体分段的示例函数
function seekToMediaSegmentAt(currentTime) {
  // 在此实现跳转逻辑
  // 这里只是占位函数
}
</script>

示例 2

<script>
async function setUpVideoStream() {
  // 指定的视频格式与编解码器
  const mediaType = 'video/mp4; codecs="mp4a.40.2,avc1.4d4015"';

  // 检查该视频格式/编解码器是否受支持。
  if (!window.ManagedMediaSource?.isTypeSupported(mediaType)) {
    return; // 不受支持，采取其他方案。
  }

  // 设置视频与其受管源。
  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);

  // 设置事件处理程序
  sourceBuffer.onbufferedchange = (e) => {
    console.log("触发 onbufferedchange 事件。");
    console.log(`新增范围: ${timeRangesToString(e.addedRanges)}`);
    console.log(`移除范围: ${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 () => {
    // 在此停止抓取新分段
  };
}

// 辅助函数...
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 Language Specification。 Ecma International。URL：https://tc39.es/ecma262/multipage/
[FILEAPI]: File API。Marijn Kruisselbrink。W3C。2024 年 12 月 4 日。W3C 工作草案。URL：https://www.w3.org/TR/FileAPI/
[HTML]: HTML Standard。Anne van Kesteren； Domenic Denicola；Dominic Farolino；Ian Hickson；Philip Jägenstedt；Simon Pieters。WHATWG。现行标准（Living Standard）。URL：https://html.spec.whatwg.org/multipage/
[infra]: Infra Standard。Anne van Kesteren；Domenic Denicola。WHATWG。现行标准（Living Standard）。URL：https://infra.spec.whatwg.org/
[MSE-REGISTRY]: Media Source Extensions™ Byte Stream Format Registry。Matthew Wolenetz；Jerry Smith；Aaron Colwell。W3C。URL： https://www.w3.org/TR/mse-byte-stream-format-registry/
[RFC2119]: Key words for use in RFCs to Indicate Requirement Levels。S. Bradner。IETF。1997 年 3 月。最佳当前实践。URL：https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]: Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words。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]: Sourcing In-band Media Resource Tracks from Media Containers into HTML。Silvia Pfeiffer；Bob Lund。W3C。 2015 年 4 月 26 日。非正式草案。URL：https://dev.w3.org/html5/html-sourcing-inband-tracks/
[MEDIA-PLAYBACK-QUALITY]: Media Playback Quality。 Mounir Lamouri；Chris Cunningham。W3C。编辑草案。URL：https://w3c.github.io/media-playback-quality/
[url]: URL Standard。Anne van Kesteren。WHATWG。现行标准（Living Standard）。URL：https://url.spec.whatwg.org/

媒体源扩展™

摘要

本文档状态

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 定位

3.15.4 SourceBuffer 监控

3.15.5 选中/启用轨道状态变更

3.15.6 时长变更

3.15.7 流结束

3.15.8 必要时镜像

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` 扩展