mirror of
https://github.com/shaka-project/shaka-player.git
synced 2026-06-15 16:06:41 +03:00
Joey Parrish
1d9e574afa
Since we no longer clear ahead of the playhead, the only way to assure responsive visual upgrade is not to buffer too far ahead. Therefore our new default buffering goal is 10 seconds instead of 30 seconds. Manual testing using Chrome's network throttling feature has shown no increase in buffering rates, so 10 seconds seems to be enough for stable connections. For situations in which 10 seconds is not enough, the bufferingGoal setting can still be customized by the application. Closes #520 Change-Id: I248c1c93dd4cdd037e6e3ca12bb207ba54845836
96 lines
2.8 KiB
Markdown
96 lines
2.8 KiB
Markdown
# Configuration
|
|
|
|
The goal of this tutorial is to introduce Shaka's configuration system and the
|
|
concepts on which it is built. More detail can be found in the API docs.
|
|
|
|
Shaka's Player object has a hierarchical configuration. The overall player
|
|
config contains sub-configs for various parts of the system, such as manifests,
|
|
streaming, and DRM.
|
|
|
|
To see the current config, you can use `player.getConfiguration()`. If you run
|
|
this without setting anything first, you get the default configuration.
|
|
|
|
Player also has a `configure()` method that takes a plain, anonymous object as
|
|
an argument. Any fields you leave out of the config object will retain their
|
|
existing values, and any fields you explicitly set as `undefined` will be
|
|
reverted to their default value.
|
|
|
|
You can use the code from {@tutorial basic-usage} and try these examples in
|
|
the JS console:
|
|
|
|
```js
|
|
player.getConfiguration();
|
|
|
|
=> Object
|
|
abr: Object
|
|
defaultBandwidthEstimate: 500000
|
|
enabled: true
|
|
manager: SimpleAbrManager
|
|
drm: Object
|
|
advanced: Object
|
|
clearKeys: Object
|
|
retryParameters: Object
|
|
backoffFactor: 2
|
|
baseDelay: 1000
|
|
fuzzFactor: 0.5
|
|
maxAttempts: 2
|
|
timeout: 0
|
|
servers: Object
|
|
manifest: Object
|
|
dash: Object
|
|
retryParameters: Object
|
|
preferredAudioLanguage: ""
|
|
preferredTextLanguage: ""
|
|
restrictions: Object
|
|
streaming: Object
|
|
bufferBehind: 30
|
|
bufferingGoal: 10
|
|
ignoreTextStreamFailures: false
|
|
rebufferingGoal: 2
|
|
retryParameters: Object
|
|
|
|
|
|
// set audio language preference to Canadian French:
|
|
player.configure({ preferredAudioLanguage: 'fr-CA' });
|
|
|
|
// set text language preference to Greek and buffering goal to 2 minutes:
|
|
player.configure({
|
|
preferredTextLanguage: 'el',
|
|
streaming: {
|
|
bufferingGoal: 120
|
|
}
|
|
});
|
|
|
|
// check audio language preference, which is still Canadian French:
|
|
player.getConfiguration().preferredAudioLanguage
|
|
|
|
// check buffering goal, which is 2 minutes:
|
|
player.getConfiguration().streaming.bufferingGoal
|
|
|
|
// check rebuffering goal, which is still the default of 2 seconds:
|
|
player.getConfiguration().streaming.rebufferingGoal
|
|
|
|
// set the rebuffering goal to 15 seconds and revert buffering goal to default:
|
|
player.configure({
|
|
streaming: {
|
|
bufferingGoal: undefined,
|
|
rebufferingGoal: 15
|
|
}
|
|
});
|
|
```
|
|
|
|
Some of these fields have immediate effects (such as language-related settings,
|
|
networking settings, and buffering settings) while some will not have any
|
|
effect until the next call to `load()` (such as DRM and manifest settings).
|
|
|
|
|
|
#### Detailed API Docs
|
|
|
|
For more detail on individual configuration options, please see the API docs for
|
|
{@link shakaExtern.PlayerConfiguration} and {@link shaka.Player#configure}.
|
|
|
|
|
|
#### Continue the Tutorials
|
|
|
|
Next, check out {@tutorial network-and-buffering-config}.
|