Merge remote-tracking branch 'origin/master'

Author: TalbotGooday

README.md

@@ -4,7 +4,7 @@ A simple library for parsing and playing links from YouTube, YouTube Music, Vime
 
 [![Release](https://jitpack.io/v/TalbotGooday/Android-Oembed-Video.svg)](https://jitpack.io/#TalbotGooday/Android-Oembed-Video)
 
-# Supported Video Hostings
+## Supported Video Hostings
 
 * <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/0/09/YouTube_full-color_icon_%282017%29.svg/1200px-YouTube_full-color_icon_%282017%29.svg.png" width=18px/>    YouTube
 
@@ -22,7 +22,7 @@ A simple library for parsing and playing links from YouTube, YouTube Music, Vime
 * <img src="https://blog.video.ibm.com/wp-content/uploads/2014/10/U_logo_blue-2.png" width=18px/> Ustream
 * <img src="https://github.com/TalbotGooday/Android-Oembed-Video/blob/master/app/src/main/res/drawable-xxhdpi/ted_talks.png" width=18px/> Ted Talks
 * <img src="https://cdn.iconscout.com/icon/free/png-512/coub-1693601-1442642.png" width=18px/> Coub
-# Screenshots
+## Screenshots
 
 <img src="/screenshots/device-2020-02-06-232720.png" width=32%/> <img src="/screenshots/device-2020-02-06-232746.png" width=32%/> <img src="/screenshots/device-2020-02-06-232924.png" width=32%/>
 
@@ -44,7 +44,7 @@ dependencies {
 
 ```
 
-# Work Flow
+## Work Flow
 1. Create your OkHttpClient and add it to the VideoService.Builder
 ```kotlin
 val okHttpClient = OkHttpClient.Builder()
@@ -70,7 +70,7 @@ videoService.loadVideoPreview(
 		//handle an error
 	})
 ```
-# Play Video from VideoPreviewModel
+## Play Video from VideoPreviewModel
 The BottomVideoController allows to run any oembed video in WebView.
 ```kotlin
 val host = model.videoHosting
@@ -96,3 +96,51 @@ BottomVideoController.build(this) {
 	show()
 }
 ```
+## How to add some other video hosting
+1. Add the `Gson` library to your project
+2. Create the `Gson` data class from the embed response of the video service. Make this class a subclass of `VideoInfoModel`, implement the` toPreview` function, and override it:
+```kotlin
+ override fun toPreview(url: String?, linkToPlay: String, hostingName: String, videoId: String): VideoPreviewModel {
+        return VideoPreviewModel(url, linkToPlay, hostingName, videoId).apply {
+            this.thumbnailUrl = this@UltimediaResponse.thumbnailUrl
+            this.videoTitle = this@UltimediaResponse.authorName
+            this.width = this@UltimediaResponse.width.toInt()
+            this.height = this@UltimediaResponse.height.toInt()
+        }
+    }
+```
+3. Create a subclass of `VideoInfoModel`, implement members and override them:
+```kotlin
+class UltimediaVideoInfoModel: VideoInfoModel<UltimediaResponse>() {
+	override val baseUrl: String
+		get() = "https://www.ultimedia.com"
+	//https://regex101.com/r/2AsrOc/1
+	override val pattern: String
+		get() = "(?:http[s]?:\\/\\/)?(?:www)?\\.?ultimedia\\.com\\/(?:deliver|default|api)\\/.*\\/([_a-zA-Z0-9]+)\\S*"
+	override val idPattern: String
+		get() = pattern //or some other another video id search pattern
+	override val type: Class<UltimediaResponse>
+		get() = UltimediaResponse::class.java
+	override val hostingName: String
+		get() = "Ultimedia"
+
+	override fun getInfoUrl(incomingUrl: String?): String? {
+		return "$baseUrl/api/search/oembed?$FORMAT=$FORMAT_JSON&$URL=$incomingUrl"
+	}
+
+	override fun getPlayLink(videoId: String): String {
+		return "https://www.ultimedia.com/deliver/generic/iframe/src/$videoId/"
+	}
+}
+``` 
+**Note:** By default, the index of the `Regex` group should be **1**. If your `idPattern` does not fulfill this condition, then override the `parseVideoId` method:
+```kotlin
+override fun parseVideoId(url: String?): String? {
+	url ?: return null
+	return idPattern.toRegex().find(url)?.groups?.get(**someIndex**)?.value
+}
+```
+## License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details
+