From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- files/zh-tw/web/api/mediasource/index.html | 144 +++++++++++++++++++++++++++++ 1 file changed, 144 insertions(+) create mode 100644 files/zh-tw/web/api/mediasource/index.html (limited to 'files/zh-tw/web/api/mediasource/index.html') diff --git a/files/zh-tw/web/api/mediasource/index.html b/files/zh-tw/web/api/mediasource/index.html new file mode 100644 index 0000000000..0006121f46 --- /dev/null +++ b/files/zh-tw/web/api/mediasource/index.html @@ -0,0 +1,144 @@ +--- +title: MediaSource +slug: Web/API/MediaSource +translation_of: Web/API/MediaSource +--- +

{{APIRef("Media Source Extensions")}}{{SeeCompatTable}}

+ +

Media Source Extensions API 的 MediaSource 介面代表 {{domxref("HTMLMediaElement")}} 物件的媒體資料來源。一個 MediaSource 物件可以被附加到一個 {{domxref("HTMLMediaElement")}} 以被用戶代理 (user agent) 播放。

+ +

{{InheritanceDiagram}}

+ +

建構子 (Constructor)

+ +
+
{{domxref("MediaSource.MediaSource", "MediaSource()")}}
+
建構且回傳一個新的 MediaSource 物件但不與任何來源緩衝 (source buffers) 關聯 (associate)。
+
+ +

屬性 (Properties)

+ +
+
{{domxref("MediaSource.sourceBuffers")}} {{readonlyInline}}
+
回傳一個含有與此 MediaSource 關聯的 {{domxref("SourceBuffer")}} 物件串列的 {{domxref("SourceBufferList")}} 物件。
+
{{domxref("MediaSource.activeSourceBuffers")}} {{readonlyInline}}
+
回傳一個 {{domxref("SourceBufferList")}} 物件，含有 {{domxref("SourceBuffers")}} 的子集合 {{domxref("SourceBuffer")}} 物件 — 物件的串列提供被選擇的影片軌 (video track), 啟用的音軌 (audio tracks), 以及顯示或隱藏的字軌。
+
{{domxref("MediaSource.readyState")}} {{readonlyInline}}
+
回傳一個列舉類型表示目前 MediaSource 的狀態：沒有附加到媒體元件 (closed)，已經附加且可以接收 {{domxref("SourceBuffer")}} 物件 (open)，已經附加但是串流已經經由 {{domxref("MediaSource.endOfStream()")}} 結束 (ended)。
+
{{domxref("MediaSource.duration")}}
+
取得或設置現在正被表示的媒體的時間長度。
+
+

事件處理函數 (Event handlers)

+ + +
+
{{domxref("MediaSource.onsourceclose")}}
+
sourceclose 事件的事件處理函數。
+
{{domxref("MediaSource.onsourceended")}}
+
sourceended 事件的事件處理函數。
+
{{domxref("MediaSource.onsourceopen")}}
+
sourceopen 事件的事件處理函數。
+
+ +
+
+ +
+
+ +

方法 (Methods)

+ +

從親介面 (parent interface) {{domxref("EventTarget")}} 繼承屬性。

+ +
+
{{domxref("MediaSource.addSourceBuffer()")}}
+
依據指定的 MIME 類型建立一個新的 {{domxref("SourceBuffer")}} 且將其加入 MediaSource 的 {{domxref("SourceBuffers")}} 串列。
+
{{domxref("MediaSource.clearLiveSeekableRange()")}}
+
清除先前藉由呼叫 setLiveSeekableRange() 所設定的可尋找範圍。
+
{{domxref("MediaSource.endOfStream()")}}
+
示意串流的結束。
+
{{domxref("MediaSource.removeSourceBuffer()")}}
+
從與此 MediaSource 物件關聯的 {{domxref("SourceBuffers")}} 串列移除指定的 {{domxref("SourceBuffer")}}。
+
{{domxref("MediaSource.setLiveSeekableRange()")}}
+
設定使用者可以在媒體元素中的可尋找範圍。
+
+ +

靜態方法 (Static methods)

+ +
+
{{domxref("MediaSource.isTypeSupported()")}}
+
回傳一個 {{domxref("Boolean")}} 值表示指定的 MIME 類型是否被現在的用戶代理支援 — 意即可否成功的為該 MIME 類型建立 {{domxref("SourceBuffer")}} 物件。
+
+ +

範例

+ +

以下簡單的範例儘快的載入一個個影片塊 (chunk) 且儘快的播放。這個範例是由 Nick Desaulniers 所撰寫且可以在此實際觀看（您也可以下載原始碼以更進一步研究）

+ +
var video = document.querySelector('video');
+
+var assetURL = 'frag_bunny.mp4';
+// Need to be specific for Blink regarding codecs
+// ./mp4info frag_bunny.mp4 | grep Codec
+var mimeCodec = 'video/mp4; codecs="avc1.42E01E, mp4a.40.2"';
+
+if ('MediaSource' in window && MediaSource.isTypeSupported(mimeCodec)) {
+  var mediaSource = new MediaSource();
+  //console.log(mediaSource.readyState); // closed
+  video.src = URL.createObjectURL(mediaSource);
+  mediaSource.addEventListener('sourceopen', sourceOpen);
+} else {
+  console.error('Unsupported MIME type or codec: ', mimeCodec);
+}
+
+function sourceOpen (_) {
+  //console.log(this.readyState); // open
+  var mediaSource = this;
+  var sourceBuffer = mediaSource.addSourceBuffer(mimeCodec);
+  fetchAB(assetURL, function (buf) {
+    sourceBuffer.addEventListener('updateend', function (_) {
+      mediaSource.endOfStream();
+      video.play();
+      //console.log(mediaSource.readyState); // ended
+    });
+    sourceBuffer.appendBuffer(buf);
+  });
+};
+
+function fetchAB (url, cb) {
+  console.log(url);
+  var xhr = new XMLHttpRequest;
+  xhr.open('get', url);
+  xhr.responseType = 'arraybuffer';
+  xhr.onload = function () {
+    cb(xhr.response);
+  };
+  xhr.send();
+};
+ +

規格

+ + + + + + + + + + + + + + +
規格狀態註釋
{{SpecName('Media Source Extensions', '#mediasource', 'MediaSource')}}{{Spec2('Media Source Extensions')}}Initial definition.
+ +

相容性表格

+ +
{{Compat("api.MediaSource")}}
+ +

相關資料

+ + -- cgit v1.2.3-54-g00ecf