云镜，是一款微小的站内资源搜索引擎库，是一款基于Go语言开发，独立于开发项目之外

<img width=300 src="./logo.svg" alt="VHS Logo consisting of a VHS tape, the Video.js logo and the words VHS" /> # videojs-http-streaming (VHS) [![Build Status][travis-icon]][travis-link] [![Slack Status][slack-icon]][slack-link] [![Greenkeeper badge][greenkeeper-icon]][greenkeeper-link] Play HLS, DASH, and future HTTP streaming protocols with video.js, even where they're not natively supported. Included in video.js 7 by default! See the [video.js 7 blog post](https://blog.videojs.com/video-js-7-is-here/) Maintenance Status: Stable Video.js Compatibility: 6.0, 7.0 <!-- START doctoc generated TOC please keep comment here to allow auto update --> <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --> - [Installation](#installation) - [NPM](#npm) - [CDN](#cdn) - [Releases](#releases) - [Manual Build](#manual-build) - [Contributing](#contributing) - [Troubleshooting](#troubleshooting) - [Talk to us](#talk-to-us) - [Getting Started](#getting-started) - [Compatibility](#compatibility) - [Browsers which support MSE](#browsers-which-support-mse) - [Native only](#native-only) - [Flash Support](#flash-support) - [DRM](#drm) - [Documentation](#documentation) - [Options](#options) - [How to use](#how-to-use) - [Initialization](#initialization) - [Source](#source) - [List](#list) - [withCredentials](#withcredentials) - [handleManifestRedirects](#handlemanifestredirects) - [useCueTags](#usecuetags) - [parse708captions](#parse708captions) - [overrideNative](#overridenative) - [blacklistDuration](#blacklistduration) - [maxPlaylistRetries](#maxplaylistretries) - [bandwidth](#bandwidth) - [useBandwidthFromLocalStorage](#usebandwidthfromlocalstorage) - [enableLowInitialPlaylist](#enablelowinitialplaylist) - [limitRenditionByPlayerDimensions](#limitrenditionbyplayerdimensions) - [useDevicePixelRatio](#usedevicepixelratio) - [smoothQualityChange](#smoothqualitychange) - [allowSeeksWithinUnsafeLiveWindow](#allowseekswithinunsafelivewindow) - [customTagParsers](#customtagparsers) - [customTagMappers](#customtagmappers) - [cacheEncryptionKeys](#cacheencryptionkeys) - [handlePartialData](#handlepartialdata) - [liveRangeSafeTimeDelta](#liverangesafetimedelta) - [useNetworkInformationApi](#usenetworkinformationapi) - [captionServices](#captionservices) - [Format](#format) - [Example](#example) - [Runtime Properties](#runtime-properties) - [vhs.playlists.master](#vhsplaylistsmaster) - [vhs.playlists.media](#vhsplaylistsmedia) - [vhs.systemBandwidth](#vhssystembandwidth) - [vhs.bandwidth](#vhsbandwidth) - [vhs.throughput](#vhsthroughput) - [vhs.selectPlaylist](#vhsselectplaylist) - [vhs.representations](#vhsrepresentations) - [vhs.xhr](#vhsxhr) - [vhs.stats](#vhsstats) - [Events](#events) - [loadedmetadata](#loadedmetadata) - [VHS Usage Events](#vhs-usage-events) - [Presence Stats](#presence-stats) - [Use Stats](#use-stats) - [In-Band Metadata](#in-band-metadata) - [Segment Metadata](#segment-metadata) - [Object as Source](#object-as-source) - [Hosting Considerations](#hosting-considerations) - [Known Issues and Workarounds](#known-issues-and-workarounds) - [Fragmented MP4 Support](#fragmented-mp4-support) - [Assets with an Audio-Only Rate Get Stuck in Audio-Only](#assets-with-an-audio-only-rate-get-stuck-in-audio-only) - [DASH Assets with `$Time` Interpolation and `SegmentTimeline`s with No `t`](#dash-assets-with-time-interpolation-and-segmenttimelines-with-no-t) - [Testing](#testing) - [Debugging](#debugging) - [Release History](#release-history) - [Building](#building) - [Development](#development) - [Tools](#tools) - [Commands](#commands) <!-- END doctoc generated TOC please keep comment here to allow auto update --> ## Installation ### NPM To install `videojs-http-streaming` with npm run ```bash npm install --save @videojs/http-streaming ``` ### CDN Select a version of VHS from the [CDN](https://unpkg.com/@videojs/http-streaming/dist/) ### Releases Download a release of [videojs-http-streaming](https://github.com/videojs/http-streaming/releases) ### Manual Build Download a copy of this git repository and then follow the steps in [Building](#building) ## Contributing See [CONTRIBUTING.md](/CONTRIBUTING.md) ## Troubleshooting See [our troubleshooting guide](/docs/troubleshooting.md) ## Talk to us Drop by our slack channel (#playback) on the [Video.js slack][slack-link]. ## Getting Started This library is included in video.js 7 by default, if you are using an older version of video.js then get a copy of [videojs-http-streaming](#installation) and include it in your page along with video.js: ```html <video-js id=vid1 width=600 height=300 class="vjs-default-skin" controls> <source src="https://example.com/index.m3u8" type="application/x-mpegURL"> </video-js> <script src="video.js"></script> <script src="videojs-http-streaming.min.js"></script> <script> var player = videojs('vid1'); player.play(); </script> ``` Check out our [live example](https://jsbin.com/gejugat/edit?html,output) if you're having trouble. Is it recommended to use the `<video-js>` element or load a source with `player.src(sourceObject)` in order to prevent the video element from playing the source natively where HLS is supported. ## Compatibility The [Media Source Extensions](http://caniuse.com/#feat=mediasource) API is required for http-streaming to play HLS or MPEG-DASH. ### Browsers which support MSE - Chrome - Firefox - Internet Explorer 11 Windows 10 or 8.1 These browsers have some level of native HLS support, which will be used unless the [overrideNative](#overridenative) option is used: - Chrome Android - Firefox Android - Edge ### Native only - Mac Safari - iOS Safari Mac Safari does have MSE support, but native HLS is recommended ### Flash Support This plugin does not support Flash playback. Instead, it is recommended that users use the [videojs-flashls-source-handler](https://github.com/brightcove/videojs-flashls-source-handler) plugin as a fallback option for browsers that don't have a native [HLS](https://caniuse.com/#feat=http-live-streaming)/[DASH](https://caniuse.com/#feat=mpeg-dash) player or support for [Media Source Extensions](http://caniuse.com/#feat=mediasource). ### DRM DRM is supported through [videojs-contrib-eme](https://github.com/videojs/videojs-contrib-eme). In order to use DRM, include the videojs-contrib-eme plug, [initialize it](https://github.com/videojs/videojs-contrib-eme#initialization), and add options to either the [plugin](https://github.com/videojs/videojs-contrib-eme#plugin-options) or the [source](https://github.com/videojs/videojs-contrib-eme#source-options). Detailed option information can be found in the [videojs-contrib-eme README](https://github.com/videojs/videojs-contrib-eme/blob/master/README.md). ## Documentation [HTTP Live Streaming](https://developer.apple.com/streaming/) (HLS) has become a de-facto standard for streaming video on mobile devices thanks to its native support on iOS and Android. There are a number of reasons independent of platform to recommend the format, though: - Supports (client-driven) adaptive bitrate selection - Delivered over standard HTTP ports - Simple, text-based manifest format - No proprietary streaming servers required Unfortunately, all the major desktop browsers except for Safari are missing HLS support. That leaves web developers in the unfortunate position of having to maintain alternate renditions of the same video and potentially having to forego HTML-based video entirely to provide the best desktop viewing experience. This project addresses that situation by providing a polyfill for HLS on browsers that have support for [Media Source Extensions](http://caniuse.com/#feat=mediasource). You can deploy a single HLS stream,