Sure, you can handle it. But should you?
Let our experts manage the tech maintenance while you focus on your business.
Let our experts manage the tech maintenance while you focus on your business.
Installation and Configuration
Microsoft Stream Connector
Copyright ©
Mindbreeze GmbH, A-4020 Linz, 2024.
All rights reserved. All hardware and software names used are brand names and/or trademarks of their respective manufacturers.
These documents are strictly confidential. The submission and presentation of these documents does not confer any rights to our software, our services and service outcomes, or any other protected rights. The dissemination, publication, or reproduction hereof is prohibited.
For ease of readability, gender differentiation has been waived. Corresponding terms and definitions apply within the meaning and intent of the equal treatment principle for both sexes.
Introduction
Using the Microsoft Stream Connector, videos from Microsoft Stream can be indexed with their metadata and subtitles. (The video files themselves are not indexed).
Configuring Microsoft Stream
Providing a Microsoft Stream User
- Create a new user in Microsoft Stream that can be used in the Mindbreeze Microsoft Stream Connector to crawl Microsoft Stream. The user must be either a user with administration rights or the owner of all videos to be indexed so that the requirements can be met to collect all necessary metadata.
Configuring Mindbreeze
Open Mindbreeze Management Center in the browser to start the configuration.
Configuring the Index
In the Indices tab, add a new index using the +Add Index button. Select the desired Index Node and Client Service and specify the Microsoft Stream data source in the Data Source field. Then confirm your entries with the Apply button.
Configuring the Data Source
Now configure the data source.
Legend:
- Properties marked with *: mandatory field, these must be configured explicitly
- Properties not specially marked: optional fields
- Fields marked with (Advanced Settings) are only displayed if the "Advanced Settings" view is enabled in the configuration. This is only necessary in special use cases.
Connection Settings
User Credentials * | The Crawling User in Microsoft Stream, |
Page Size | The number of videos that are fetched from Microsoft Stream at the same time. The page size must be between 1 and 100. |
Log All Requests | If this option is activated, all requests to Microsoft Stream are written to the log file "request-log.csv" as long as the login is successful. The list of requests with description can be found here. |
Content Settings
Subtitle Language | The language of the subtitles to be used as content. If there are no subtitles in this language, the video will be indexed without content/subtitles. The value must be a two-character long language code (ISO 639-1) from this list: List of codes. |
Index Unpublished Videos | If this option is enabled, videos that have not yet been published in Microsoft Stream will also be indexed. |
Configuring the Caching Principal Resolution Service
The Microsoft Stream Connector requires the Microsoft Azure Principal Resolution Service. You can find out how to set this up here.
To connect the crawler and the caching Principal Resolution Service, select the added Microsoft Azure Principal Resolution Service in the Caching Principal Resolution Service field in the Microsoft Stream Crawler Configuration (Data Source).
List of requests
Request | HTTP- | Description |
<ApiBaseUrl>/api/videos | GET | Fetching all videos (which are visible to the user) from Microsoft Stream. |
<ApiBaseUrl>/api/videos/<videoId>/roleassignments | GET | Fetching the permissions for the corresponding video so that the ACLs can be recreated in Mindbreeze. |
<ApiBaseUrl>/api/videos/<videoId>/texttracks | GET | Fetching all subtitle tracks for the corresponding video. |
<ApiBaseUrl>/api/texttracks/<IDs> | GET | Downloading the subtitle track. |