Enhance video content functions with HTTPHeaderList and APIs

Added support for custom HTTP headers in video content functions.

Author: OskarFreestyle

hisplayer-api.md

@@ -96,6 +96,21 @@ The following public APIs are provided by **HISPlayerManager**
 * **public struct HISPlayerCaptionElement**: The information of the triggered event turns into caption’s format.
    * **public int playerIndex**: The index of the player where the event is triggered.
    * **public string caption**: The next generated caption text.
+ 
+* **public struct HTTPHeader**: Information for a custom HTTP header:
+    * **public string key**: Key of the HTTP header.
+    * **public string value**: Value of the HTTP header.
+
+* **public class HTTPHeaderList**: Wrapper class for a list of custom HTTP headers.
+    * **public List \<HTTPHeader\> headers**: List of HTTP headers.
+    * **public int Count (Read-only)**: Number of HTTP headers.
+    * **public void Add(string key, string value)**: Adds a new HTTP header given a **key** and a **value**.
+    * **public void Add(HTTPHeader header)**: Adds an existing **HTTPHeader**.
+    * **public bool Remove(string key)**: Removes the first header matching the given **key**. Returns true if a header was removed.
+    * **public bool Remove(HTTPHeader header)**: Removes a specific **HTTPHeader**. Returns true if the header was removed.
+    * **public void Clear()**: Removes all HTTP headers.
+    * **public bool Contains(string key)**: Returns true if a header with the given **key** exists.
+    * **public string Get(string key)**: Returns the value of the header matching the given **key**, or null if it does not exist.
 
 ## Functions
 The following functions are provided by **HISPlayerManager**. They are **not public** so it’s necessary to create a custom script which inherits from **HISPlayerManager**.
@@ -318,6 +333,9 @@ Add new content to a certain player. If the **enableDRM** variable is true, a vi
 #### void AddVideoContent(int playerIndex, string url, string keyServerUri,  string tokenKey = “” (optional), string tokenValue= “” (optional), HISPlayerMimeTypes mimeType = HISPlayerMimeTypes.URL_EXTENSION (optional))
 Add new content to a certain player and its respective key server uri (tokenKey and tokenValue are optional parameters). The enableDRM variable must be true to use this function. The **playerIndex** is associated with the index of the element of **Multi Stream Properties**, e.g. the index 0 is the element 0 in the list. The **url** is the link to the new video. The keyServerUri is the token key associated with the URL. Please, make sure the string is correct. The **mimeType** parameter is optional and indicates which MIME type will be used for the new url.
 
+#### void AddVideoContent(int playerIndex, string url, HTTPHeaderList httpHeaderList, HISPlayerMimeTypes mimeType = HISPlayerMimeTypes.URL_EXTENSION (optional))
+Add new content to a certain player including custom HTTP headers. The **playerIndex** is associated with the index of the element of **Multi Stream Properties**, e.g. the index 0 is the element 0 in the list. The **url** is the link to the new video. Please, make sure the string is correct. This function supports local file paths. The **httpHeaderList** contains the custom HTTP headers that will be attached to the requests for this content. The parameter **mimeType** is optional and indicates which MIME type will be used for the new url.
+
 #### void ChangeVideoContent(int playerIndex, int urlIndex)
 Change the video’s URL  of a certain player. The next playback will start paused if **autoPlay** is disabled. The **playerIndex** is associated with the index of the element of **Multi Stream Properties**, e.g. the index 0 is the element 0 in the list. The **urlIndex** is associated with the index of the element in the list of URLs.
 
@@ -330,6 +348,9 @@ Change the video’s URL of a certain player given a new URL. The next playback
 #### void ChangeVideoContent(int playerIndex, string url, string keyServerUri, string token key = “” (optional), string token value= “” (optional), HISPlayerMimeTypes mimeType = HISPlayerMimeTypes.URL_EXTENSION (optional))
 Change the video’s URL of a certain player given a new URL with DRM protection (tokenKey and tokenValue are optional parameters). The next playback will start paused if **autoPlay** is disabled. The **playerIndex** is associated with the index of the element of **Multi Stream Properties**, e.g. the index 0 is the element 0 in the list. The parameter **url** is the link to the new video. The **keyServerUri** is the license key associated with the URL. Please, make sure the parameters are correctly written. This function supports local file paths. The **mimeType** parameter is optional and indicates which MIME type will be used for the new url.
 
+#### void ChangeVideoContent(int playerIndex, string url, HTTPHeaderList httpHeaderList)
+Change the video's URL of a certain player given a new URL including custom HTTP headers. The next playback will start paused if **autoPlay** is disabled. The **playerIndex** is associated with the index of the element of **Multi Stream Properties**, e.g. the index 0 is the element 0 in the list. The parameter **url** is the link to the new video. Please, make sure the new URL is correctly written. This function supports local file paths. This function will replace the Playlist with the new URL. The **httpHeaderList** contains the custom HTTP headers that will be attached to the requests for this content.
+
 #### void RemoveVideoContent(int playerIndex, int urlIndex)
 Remove content from a certain player. The **playerIndex** is associated with the index of the element of **Multi Stream Properties**, e.g. the index 0 is the element 0 in the list.  The **urlIndex** is associated with the index of the element in the list of URLs.