From cbeb024d0665e40319029463b102dcdf33919291 Mon Sep 17 00:00:00 2001
From: ThibaultBee <37510686+ThibaultBee@users.noreply.github.com>
Date: Tue, 19 Mar 2024 16:35:27 +0100
Subject: [PATCH] refactor(player): rename videoId to mediaId

---
 .../video/api/player/example/MainActivity.kt  |  6 ++--
 examples/view/src/main/res/values/strings.xml |  4 +--
 .../src/main/res/xml/root_preferences.xml     |  4 +--
 .../models/ApiVideoExoPlayerMediaFactory.kt   |  2 +-
 .../video/api/player/models/VideoOptions.kt   | 32 +++++++++----------
 .../main/java/video/api/player/utils/Utils.kt |  6 ++--
 .../api/player/models/VideoOptionsTest.kt     | 24 +++++++-------
 7 files changed, 39 insertions(+), 39 deletions(-)

diff --git a/examples/view/src/main/java/video/api/player/example/MainActivity.kt b/examples/view/src/main/java/video/api/player/example/MainActivity.kt
index cbc10e6..b3f392b 100644
--- a/examples/view/src/main/java/video/api/player/example/MainActivity.kt
+++ b/examples/view/src/main/java/video/api/player/example/MainActivity.kt
@@ -25,8 +25,8 @@ class MainActivity : AppCompatActivity() {
     private val sharedPref: SharedPreferences by lazy {
         PreferenceManager.getDefaultSharedPreferences(this)
     }
-    private val videoId: String
-        get() = sharedPref.getString(getString(R.string.video_id_key), null)
+    private val mediaId: String
+        get() = sharedPref.getString(getString(R.string.media_id_key), null)
             ?: throw IllegalArgumentException("Video ID is not set")
     private val videoType: VideoType
         get() {
@@ -190,7 +190,7 @@ class MainActivity : AppCompatActivity() {
 
     private fun loadVideo() {
         try {
-            playerController.videoOptions = VideoOptions(videoId, videoType, privateVideoToken)
+            playerController.videoOptions = VideoOptions(mediaId, videoType, privateVideoToken)
         } catch (e: Exception) {
             Log.e(TAG, "Error while loading video", e)
             displayMessage("Error while loading video: ${e.message}")
diff --git a/examples/view/src/main/res/values/strings.xml b/examples/view/src/main/res/values/strings.xml
index 1fe8809..33dd741 100644
--- a/examples/view/src/main/res/values/strings.xml
+++ b/examples/view/src/main/res/values/strings.xml
@@ -4,8 +4,8 @@
 
     <!--Settings-->
     <string name="default_video_id">vi77Dgk0F8eLwaFOtC5870yn</string>
-    <string name="video_id_key">video_id_key</string>
-    <string name="video_id">VideoId</string>
+    <string name="media_id_key">media_id_key</string>
+    <string name="media_id">MediaId</string>
     <string name="video_type_key">video_type_key</string>
     <string name="video_type_vod">VOD</string>
     <string name="video_type_live">Live</string>
diff --git a/examples/view/src/main/res/xml/root_preferences.xml b/examples/view/src/main/res/xml/root_preferences.xml
index b663804..84420a6 100644
--- a/examples/view/src/main/res/xml/root_preferences.xml
+++ b/examples/view/src/main/res/xml/root_preferences.xml
@@ -3,8 +3,8 @@
 
     <EditTextPreference
         app:defaultValue="@string/default_video_id"
-        app:key="@string/video_id_key"
-        app:title="@string/video_id"
+        app:key="@string/media_id_key"
+        app:title="@string/media_id"
         app:useSimpleSummaryProvider="true" />
 
     <SwitchPreference
diff --git a/player/src/main/java/video/api/player/models/ApiVideoExoPlayerMediaFactory.kt b/player/src/main/java/video/api/player/models/ApiVideoExoPlayerMediaFactory.kt
index fbb9ce1..bbb240e 100644
--- a/player/src/main/java/video/api/player/models/ApiVideoExoPlayerMediaFactory.kt
+++ b/player/src/main/java/video/api/player/models/ApiVideoExoPlayerMediaFactory.kt
@@ -99,7 +99,7 @@ class ApiVideoExoPlayerMediaFactory(
             .build()
         return MediaItem.Builder()
             .setUri(request.uri)
-            .setMediaId(videoOptions.videoId)
+            .setMediaId(videoOptions.mediaId)
             .setTag(videoOptions)
             .setMediaMetadata(mediaMetadata)
             .setMimeType(
diff --git a/player/src/main/java/video/api/player/models/VideoOptions.kt b/player/src/main/java/video/api/player/models/VideoOptions.kt
index 1a15a1e..d871159 100644
--- a/player/src/main/java/video/api/player/models/VideoOptions.kt
+++ b/player/src/main/java/video/api/player/models/VideoOptions.kt
@@ -6,30 +6,30 @@ import java.net.URL
 /**
  * Description of the video to play.
  *
- * @constructor Creates a [VideoOptions] from a [videoId]. an explicit [VideoType] and the private [token].
- * @param videoId the video ID of the video to play
+ * @constructor Creates a [VideoOptions] from a [mediaId]. an explicit [VideoType] and the private [token].
+ * @param mediaId the video ID of the video or the live stream ID
  * @param videoType the [VideoType] of the video to play. Only [VideoType.VOD] is supported.
  * @param token the private video token (only needed for private video, set to null otherwise)
  */
 data class VideoOptions(
-    val videoId: String,
+    val mediaId: String,
     val videoType: VideoType,
     val token: String? = null
 ) {
-    private val baseUrl = "${videoType.baseUrl}/$videoId"
+    private val baseUrl = "${videoType.baseUrl}/$mediaId"
     private val vodUrl = baseUrl + (token?.let { "/token/$it" } ?: "")
-    private val liveUrl = videoType.baseUrl + (token?.let { "/private/$it" } ?: "") + "/$videoId"
+    private val liveUrl = videoType.baseUrl + (token?.let { "/private/$it" } ?: "") + "/$mediaId"
 
     /**
-     * Creates a [VideoOptions] from a [videoId] and the private [token].
+     * Creates a [VideoOptions] from a [mediaId] and the private [token].
      * The [VideoType] is inferred from the video ID.
      *
-     * @param videoId the video ID of the video to play
+     * @param mediaId the video ID of the video or the live stream ID
      * @param token the private video token (only needed for private video, set to null otherwise)
      */
-    constructor(videoId: String, token: String?) : this(
-        videoId,
-        inferVideoType(videoId),
+    constructor(mediaId: String, token: String?) : this(
+        mediaId,
+        inferVideoType(mediaId),
         token
     )
 
@@ -81,19 +81,19 @@ data class VideoOptions(
         ) = url.parseAsVideoOptions()
 
         /**
-         * Infers the [VideoType] from the videoId.
+         * Infers the [VideoType] from the mediaId.
          *
-         * @param videoId the video ID
+         * @param mediaId the video ID or the live stream ID
          * @return the [VideoType]
          */
-        private fun inferVideoType(videoId: String): VideoType {
-            return if (videoId.startsWith("vi")) {
+        private fun inferVideoType(mediaId: String): VideoType {
+            return if (mediaId.startsWith("vi")) {
                 VideoType.VOD
-            } else if (videoId.startsWith("li")) {
+            } else if (mediaId.startsWith("li")) {
                 VideoType.LIVE
             } else {
                 throw IllegalArgumentException(
-                    "Failed to infer the video type from the videoId: $videoId"
+                    "Failed to infer the video type from the mediaId: $mediaId"
                 )
             }
         }
diff --git a/player/src/main/java/video/api/player/utils/Utils.kt b/player/src/main/java/video/api/player/utils/Utils.kt
index 0c53928..d05590e 100644
--- a/player/src/main/java/video/api/player/utils/Utils.kt
+++ b/player/src/main/java/video/api/player/utils/Utils.kt
@@ -33,12 +33,12 @@ object Utils {
         try {
             matcher.find()
             // Group naming is not supported before Android API 26
-            val videoId = matcher.group(2) ?: throw IOException("Failed to get videoId")
+            val mediaId = matcher.group(2) ?: throw IOException("Failed to get mediaId")
 
             // For live, we might not have a type for now because there isn't any `/live/` in the URL.
             val firstGroup = matcher.group(1)
             val videoType = firstGroup?.toVideoType()
-                ?: if (videoId.startsWith("li")) VideoType.LIVE else throw IOException(
+                ?: if (mediaId.startsWith("li")) VideoType.LIVE else throw IOException(
                     "Failed to get videoType"
                 )
 
@@ -52,7 +52,7 @@ object Utils {
                 }
 
             return VideoOptions(
-                videoId,
+                mediaId,
                 videoType,
                 token
             )
diff --git a/player/src/test/java/video/api/player/models/VideoOptionsTest.kt b/player/src/test/java/video/api/player/models/VideoOptionsTest.kt
index db3f10a..740e073 100644
--- a/player/src/test/java/video/api/player/models/VideoOptionsTest.kt
+++ b/player/src/test/java/video/api/player/models/VideoOptionsTest.kt
@@ -72,7 +72,7 @@ class VideoOptionsTest {
     fun `test parse embed vod url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://embed.api.video/vod/vi5oNqxkifcXkT4auGNsvgZB")
-        assertEquals(videoOptions.videoId, "vi5oNqxkifcXkT4auGNsvgZB")
+        assertEquals(videoOptions.mediaId, "vi5oNqxkifcXkT4auGNsvgZB")
         assertEquals(videoOptions.videoType, VideoType.VOD)
         assertNull(videoOptions.token)
     }
@@ -81,7 +81,7 @@ class VideoOptionsTest {
     fun `test parse vod url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://vod.api.video/vod/vi5oNqxkifcXkT4auGNsvgZB/hls/manifest.m3u8")
-        assertEquals(videoOptions.videoId, "vi5oNqxkifcXkT4auGNsvgZB")
+        assertEquals(videoOptions.mediaId, "vi5oNqxkifcXkT4auGNsvgZB")
         assertEquals(videoOptions.videoType, VideoType.VOD)
         assertNull(videoOptions.token)
     }
@@ -90,7 +90,7 @@ class VideoOptionsTest {
     fun `test parse private vod url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://vod.api.video/vod/vi5oNqxkifcXkT4auGNsvgZB/token/PRIVATE_TOKEN/hls/manifest.m3u8")
-        assertEquals(videoOptions.videoId, "vi5oNqxkifcXkT4auGNsvgZB")
+        assertEquals(videoOptions.mediaId, "vi5oNqxkifcXkT4auGNsvgZB")
         assertEquals(videoOptions.videoType, VideoType.VOD)
         assertEquals(videoOptions.token, "PRIVATE_TOKEN")
     }
@@ -99,7 +99,7 @@ class VideoOptionsTest {
     fun `test parse MP4 vod url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://vod.api.video/vod/vi5oNqxkifcXkT4auGNsvgZB/mp4/source.mp4")
-        assertEquals(videoOptions.videoId, "vi5oNqxkifcXkT4auGNsvgZB")
+        assertEquals(videoOptions.mediaId, "vi5oNqxkifcXkT4auGNsvgZB")
         assertEquals(videoOptions.videoType, VideoType.VOD)
         assertNull(videoOptions.token)
     }
@@ -108,7 +108,7 @@ class VideoOptionsTest {
     fun `test parse private MP4 vod url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://vod.api.video/vod/vi5oNqxkifcXkT4auGNsvgZB/token/PRIVATE_TOKEN/mp4/source.mp4")
-        assertEquals(videoOptions.videoId, "vi5oNqxkifcXkT4auGNsvgZB")
+        assertEquals(videoOptions.mediaId, "vi5oNqxkifcXkT4auGNsvgZB")
         assertEquals(videoOptions.videoType, VideoType.VOD)
         assertEquals(videoOptions.token, "PRIVATE_TOKEN")
     }
@@ -117,7 +117,7 @@ class VideoOptionsTest {
     fun `test parse embed live url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://embed.api.video/live/li77ACbZjzEJgmr8d0tm4xFt")
-        assertEquals(videoOptions.videoId, "li77ACbZjzEJgmr8d0tm4xFt")
+        assertEquals(videoOptions.mediaId, "li77ACbZjzEJgmr8d0tm4xFt")
         assertEquals(videoOptions.videoType, VideoType.LIVE)
         assertNull(videoOptions.token)
     }
@@ -126,7 +126,7 @@ class VideoOptionsTest {
     fun `test parse live url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://live.api.video/li77ACbZjzEJgmr8d0tm4xFt.m3u8")
-        assertEquals(videoOptions.videoId, "li77ACbZjzEJgmr8d0tm4xFt")
+        assertEquals(videoOptions.mediaId, "li77ACbZjzEJgmr8d0tm4xFt")
         assertEquals(videoOptions.videoType, VideoType.LIVE)
         assertNull(videoOptions.token)
     }
@@ -135,7 +135,7 @@ class VideoOptionsTest {
     fun `test parse private live url`() {
         val videoOptions =
             VideoOptions.fromUrl("https://live.api.video/private/PRIVATE_TOKEN/li77ACbZjzEJgmr8d0tm4xFt.m3u8")
-        assertEquals(videoOptions.videoId, "li77ACbZjzEJgmr8d0tm4xFt")
+        assertEquals(videoOptions.mediaId, "li77ACbZjzEJgmr8d0tm4xFt")
         assertEquals(videoOptions.videoType, VideoType.LIVE)
         assertEquals(videoOptions.token, "PRIVATE_TOKEN")
     }
@@ -146,7 +146,7 @@ class VideoOptionsTest {
             VideoOptions.fromUrl(
                 "https://mycustom.vod.domain/vod/vi5oNqxkifcXkT4auGNsvgZB/hls/manifest.m3u8"
             )
-        assertEquals(videoOptions.videoId, "vi5oNqxkifcXkT4auGNsvgZB")
+        assertEquals(videoOptions.mediaId, "vi5oNqxkifcXkT4auGNsvgZB")
         assertEquals(videoOptions.videoType, VideoType.VOD)
         assertNull(videoOptions.token)
     }
@@ -157,7 +157,7 @@ class VideoOptionsTest {
             VideoOptions.fromUrl(
                 "https://mycustom.vod.domain/vod/vi5oNqxkifcXkT4auGNsvgZB/token/PRIVATE_TOKEN/hls/manifest.m3u8"
             )
-        assertEquals(videoOptions.videoId, "vi5oNqxkifcXkT4auGNsvgZB")
+        assertEquals(videoOptions.mediaId, "vi5oNqxkifcXkT4auGNsvgZB")
         assertEquals(videoOptions.videoType, VideoType.VOD)
         assertEquals(videoOptions.token, "PRIVATE_TOKEN")
     }
@@ -167,7 +167,7 @@ class VideoOptionsTest {
         val videoOptions = VideoOptions.fromUrl(
             "https://mycustom.live.domain/li77ACbZjzEJgmr8d0tm4xFt.m3u8"
         )
-        assertEquals(videoOptions.videoId, "li77ACbZjzEJgmr8d0tm4xFt")
+        assertEquals(videoOptions.mediaId, "li77ACbZjzEJgmr8d0tm4xFt")
         assertEquals(videoOptions.videoType, VideoType.LIVE)
         assertNull(videoOptions.token)
     }
@@ -178,7 +178,7 @@ class VideoOptionsTest {
             VideoOptions.fromUrl(
                 "https://mycustom.live.domain/private/PRIVATE_TOKEN/li77ACbZjzEJgmr8d0tm4xFt.m3u8"
             )
-        assertEquals(videoOptions.videoId, "li77ACbZjzEJgmr8d0tm4xFt")
+        assertEquals(videoOptions.mediaId, "li77ACbZjzEJgmr8d0tm4xFt")
         assertEquals(videoOptions.videoType, VideoType.LIVE)
         assertEquals(videoOptions.token, "PRIVATE_TOKEN")
     }