From 0e0231259759d63ae2b17aec9e7ec3fc97cd64bf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81lvaro=20Velad=20Galv=C3=A1n?= <alvaro.velad@mirada.tv>
Date: Sat, 21 Aug 2021 14:08:42 +0200
Subject: [PATCH] docs: Add blob-url tutorial (#3586)

Closes #1481
---
 docs/tutorials/blob-url.md | 15 +++++++++++++++
 docs/tutorials/index.json  |  1 +
 2 files changed, 16 insertions(+)
 create mode 100644 docs/tutorials/blob-url.md

diff --git a/docs/tutorials/blob-url.md b/docs/tutorials/blob-url.md
new file mode 100644
index 000000000..b33018887
--- /dev/null
+++ b/docs/tutorials/blob-url.md
@@ -0,0 +1,15 @@
+# Blob URL
+
+In case you need shaka-player to load a blob url mpd:
+
+`player.load(computedMpdBlobURL, startTime, 'application/dash+xml');`
+
+
+In case you need shaka-player to load a blob url m3u8 :
+
+`player.load(computedMpdBlobURL, startTime, 'application/x-mpegurl');`
+
+
+Note: relative URIs in the manifest are broken because the original manifest URI is lost. This can be worked around with either absolute URIs or the use of BaseURL element in DASH.
+
+Note: this tutorial only applies to v3.3 or higher
diff --git a/docs/tutorials/index.json b/docs/tutorials/index.json
index 3de1dbe24..de50bf897 100644
--- a/docs/tutorials/index.json
+++ b/docs/tutorials/index.json
@@ -18,6 +18,7 @@
   { "offline": { "title": "Offline Storage and Playback" } },
   { "fairplay": { "title": "FairPlay support" } },
   { "application-level-redirects": { "title": "Application-Level Redirects" } },
+  { "blob-url": { "title": "Blob URL" } },
   { "faq": { "title": "Frequently Asked Questions" } },
   { "upgrade": {
       "title": "Upgrade Guide",