docs: publish site from a9463246
This commit is contained in:
gitea-actions
File diff suppressed because one or more lines are too long
@@ -0,0 +1,11 @@
|
||||
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Seconds reported by an engine, as a `Duration`, without trusting the number."><title>duration_from_secs in jellytau_lib::player::media_player - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc fn"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">duration_from_secs</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.11.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>media_<wbr>player</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">media_player</a></div><h1>Function <span class="fn">duration_<wbr>from_<wbr>secs</span> <button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/media_player.rs.html#50-52">Source</a> </span></div><pre class="rust item-decl"><code>pub fn duration_from_secs(seconds: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="https://doc.rust-lang.org/1.97.1/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>></code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Seconds reported by an engine, as a <code>Duration</code>, without trusting the number.</p>
|
||||
<p><code>Duration::from_secs_f64</code> <strong>panics</strong> on a negative or non-finite value, and
|
||||
no engine promises otherwise. ExoPlayer reports <code>C.TIME_UNSET</code> —
|
||||
<code>Long::MIN_VALUE</code>, about -9.2e15 — for a stream whose length it does not
|
||||
know, which is every background-audio handoff: <code>/Audio/{id}/universal</code> is a
|
||||
chunked, length-less transcode.</p>
|
||||
<p>Held as a float that junk was harmless. Converted to a <code>Duration</code> it became
|
||||
a panic that killed the backend mid-handoff and left a black screen with no
|
||||
controls. Every engine crossing into this contract goes through here.</p>
|
||||
<p>TRACES: UR-005 | DR-252</p>
|
||||
</div></details></section></div></main></body></html>
|
||||
@@ -0,0 +1,20 @@
|
||||
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="The `MediaPlayer` contract: one API, interchangeable engines."><title>jellytau_lib::player::media_player - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="../sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc mod"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">Module media_player</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.11.1</span></h2></div><div class="sidebar-elems"><section id="rustdoc-toc"><h2 class="location"><a href="#">Module media_<wbr>player</a></h2><h3><a href="#structs">Module Items</a></h3><ul class="block"><li><a href="#structs" title="Structs">Structs</a></li><li><a href="#enums" title="Enums">Enums</a></li><li><a href="#traits" title="Traits">Traits</a></li><li><a href="#functions" title="Functions">Functions</a></li></ul></section><div id="rustdoc-modnav"><h2><a href="../index.html">In jellytau_<wbr>lib::<wbr>player</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a></div><h1>Module <span>media_<wbr>player</span> <button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/media_player.rs.html#1-328">Source</a> </span></div><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>The <code>MediaPlayer</code> contract: one API, interchangeable engines.</p>
|
||||
<p>See docs/specs/media-player-controller.md.</p>
|
||||
<p>This replaces <a href="../backend/trait.PlayerBackend.html" title="trait jellytau_lib::player::backend::PlayerBackend"><code>PlayerBackend</code></a>, which
|
||||
abstracts a <em>device</em> — <code>load</code>, then <code>seek</code> — rather than an <em>intent</em>. That
|
||||
distinction is not academic; it produced four shipped defects in one day:</p>
|
||||
<ul>
|
||||
<li>A start position was not expressible, so every caller sequenced
|
||||
<code>load()</code> + <code>seek()</code> itself and each raced the engine’s asynchronous load
|
||||
independently. Resume worked through one caller and silently failed through
|
||||
another (DR-241).</li>
|
||||
<li>Whether a stream could be seeked in place was decided <em>above</em> the engines,
|
||||
by a truth table in a command handler, for engines it does not own (DR-238).</li>
|
||||
<li>Nothing in the contract obliged an engine to report its own state, so a
|
||||
handler for mpv’s <code>pause</code> property sat unreachable and the play/pause
|
||||
control never moved (DR-239).</li>
|
||||
</ul>
|
||||
<p>The contract below is written so each of those is a compile-time or
|
||||
conformance-time failure rather than a runtime surprise.</p>
|
||||
<p>TRACES: UR-081 | DR-242</p>
|
||||
</div></details><h2 id="structs" class="section-header">Structs<a href="#structs" class="anchor">§</a></h2><dl class="item-table"><dt><a class="struct" href="struct.Capabilities.html" title="struct jellytau_lib::player::media_player::Capabilities">Capabilities</a></dt><dd>What an engine can do, so callers adapt without naming engines.</dd><dt><a class="struct" href="struct.OpenRequest.html" title="struct jellytau_lib::player::media_player::OpenRequest">Open<wbr>Request</a></dt><dd>A request to present an item.</dd><dt><a class="struct" href="struct.PlaybackSnapshot.html" title="struct jellytau_lib::player::media_player::PlaybackSnapshot">Playback<wbr>Snapshot</a></dt><dd>Everything the UI consumes, read as one coherent value.</dd></dl><h2 id="enums" class="section-header">Enums<a href="#enums" class="anchor">§</a></h2><dl class="item-table"><dt><a class="enum" href="enum.Phase.html" title="enum jellytau_lib::player::media_player::Phase">Phase</a></dt><dd>What an engine is doing right now.</dd></dl><h2 id="traits" class="section-header">Traits<a href="#traits" class="anchor">§</a></h2><dl class="item-table"><dt><a class="trait" href="trait.MediaPlayer.html" title="trait jellytau_lib::player::media_player::MediaPlayer">Media<wbr>Player</a></dt><dd>Anything that can present media.</dd></dl><h2 id="functions" class="section-header">Functions<a href="#functions" class="anchor">§</a></h2><dl class="item-table"><dt><a class="fn" href="fn.duration_from_secs.html" title="fn jellytau_lib::player::media_player::duration_from_secs">duration_<wbr>from_<wbr>secs</a></dt><dd>Seconds reported by an engine, as a <code>Duration</code>, without trusting the number.</dd></dl></section></div></main></body></html>
|
||||
@@ -0,0 +1 @@
|
||||
window.SIDEBAR_ITEMS = {"enum":["Phase"],"fn":["duration_from_secs"],"struct":["Capabilities","OpenRequest","PlaybackSnapshot"],"trait":["MediaPlayer"]};
|
||||
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -0,0 +1,58 @@
|
||||
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Anything that can present media."><title>MediaPlayer in jellytau_lib::player::media_player - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc trait"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">MediaPlayer</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.11.1</span></h2></div><div class="sidebar-elems"><section id="rustdoc-toc"><h2 class="location"><a href="#">Media<wbr>Player</a></h2><h3><a href="#required-methods">Required Methods</a></h3><ul class="block"><li><a href="#tymethod.capabilities" title="capabilities">capabilities</a></li><li><a href="#tymethod.close" title="close">close</a></li><li><a href="#tymethod.open" title="open">open</a></li><li><a href="#tymethod.pause" title="pause">pause</a></li><li><a href="#tymethod.play" title="play">play</a></li><li><a href="#tymethod.seek" title="seek">seek</a></li><li><a href="#tymethod.select_audio_track" title="select_audio_track">select_audio_track</a></li><li><a href="#tymethod.select_subtitle_track" title="select_subtitle_track">select_subtitle_track</a></li><li><a href="#tymethod.set_muted" title="set_muted">set_muted</a></li><li><a href="#tymethod.set_rate" title="set_rate">set_rate</a></li><li><a href="#tymethod.set_volume" title="set_volume">set_volume</a></li><li><a href="#tymethod.snapshot" title="snapshot">snapshot</a></li></ul><h3><a href="#provided-methods">Provided Methods</a></h3><ul class="block"><li><a href="#method.audio_settings" title="audio_settings">audio_settings</a></li><li><a href="#method.set_audio_settings" title="set_audio_settings">set_audio_settings</a></li></ul><h3><a href="#implementors">Implementors</a></h3></section><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>media_<wbr>player</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">media_player</a></div><h1>Trait <span class="trait">Media<wbr>Player</span> <button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/media_player.rs.html#247-299">Source</a> </span></div><pre class="rust item-decl"><code>pub trait MediaPlayer: <a class="trait" href="https://doc.rust-lang.org/1.97.1/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> {
|
||||
<details class="toggle type-contents-toggle"><summary class="hideme"><span>Show 14 methods</span></summary> // Required methods
|
||||
fn <a href="#tymethod.open" class="fn">open</a>(&mut self, req: <a class="struct" href="struct.OpenRequest.html" title="struct jellytau_lib::player::media_player::OpenRequest">OpenRequest</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.play" class="fn">play</a>(&mut self) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.pause" class="fn">pause</a>(&mut self) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.close" class="fn">close</a>(&mut self) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.seek" class="fn">seek</a>(&mut self, to: <a class="struct" href="https://doc.rust-lang.org/1.97.1/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.set_volume" class="fn">set_volume</a>(&mut self, volume: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f32.html">f32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.set_muted" class="fn">set_muted</a>(&mut self, muted: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.bool.html">bool</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.set_rate" class="fn">set_rate</a>(&mut self, rate: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.select_audio_track" class="fn">select_audio_track</a>(
|
||||
&mut self,
|
||||
index: <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.i32.html">i32</a>>,
|
||||
) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.select_subtitle_track" class="fn">select_subtitle_track</a>(
|
||||
&mut self,
|
||||
index: <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.i32.html">i32</a>>,
|
||||
) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.snapshot" class="fn">snapshot</a>(&self) -> <a class="struct" href="struct.PlaybackSnapshot.html" title="struct jellytau_lib::player::media_player::PlaybackSnapshot">PlaybackSnapshot</a>;
|
||||
<span class="item-spacer"></span> fn <a href="#tymethod.capabilities" class="fn">capabilities</a>(&self) -> <a class="struct" href="struct.Capabilities.html" title="struct jellytau_lib::player::media_player::Capabilities">Capabilities</a>;
|
||||
|
||||
// Provided methods
|
||||
fn <a href="#method.set_audio_settings" class="fn">set_audio_settings</a>(
|
||||
&mut self,
|
||||
_settings: &<a class="struct" href="../../settings/struct.AudioSettings.html" title="struct jellytau_lib::settings::AudioSettings">AudioSettings</a>,
|
||||
) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>> { ... }
|
||||
<span class="item-spacer"></span> fn <a href="#method.audio_settings" class="fn">audio_settings</a>(&self) -> <a class="struct" href="../../settings/struct.AudioSettings.html" title="struct jellytau_lib::settings::AudioSettings">AudioSettings</a> { ... }
|
||||
</details>}</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Anything that can present media.</p>
|
||||
<p>Implementations: <code>MpvPlayer</code> (Linux/Windows), <code>ExoPlayerPlayer</code> (Android),
|
||||
<code>WebviewPlayer</code> (HTML5 element), and <code>FakePlayer</code> for tests. Every one of
|
||||
them must pass [<code>super::conformance</code>].</p>
|
||||
</div></details><h2 id="required-methods" class="section-header">Required Methods<a href="#required-methods" class="anchor">§</a></h2><div class="methods"><details class="toggle method-toggle" open><summary><section id="tymethod.open" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#255">Source</a><h4 class="code-header">fn <a href="#tymethod.open" class="fn">open</a>(&mut self, req: <a class="struct" href="struct.OpenRequest.html" title="struct jellytau_lib::player::media_player::OpenRequest">OpenRequest</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section></summary><div class="docblock"><p>Present <code>req.selection</code>, beginning at <code>req.start</code>.</p>
|
||||
<p>One operation, deliberately. An engine that cannot start at an offset
|
||||
natively absorbs that internally — by deferring until loaded, or by
|
||||
re-opening — because it is the only layer that knows when it can.
|
||||
Callers must never follow <code>open</code> with a <code>seek</code> to achieve a start
|
||||
position; that is the bug this signature exists to prevent.</p>
|
||||
</div></details><section id="tymethod.play" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#257">Source</a><h4 class="code-header">fn <a href="#tymethod.play" class="fn">play</a>(&mut self) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section><section id="tymethod.pause" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#258">Source</a><h4 class="code-header">fn <a href="#tymethod.pause" class="fn">pause</a>(&mut self) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section><details class="toggle method-toggle" open><summary><section id="tymethod.close" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#265">Source</a><h4 class="code-header">fn <a href="#tymethod.close" class="fn">close</a>(&mut self) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section></summary><div class="docblock"><p>Stop and release the current item.</p>
|
||||
<p>Must be <strong>idempotent</strong> and must leave the engine <strong>silent</strong>. “Stopped”
|
||||
and “producing no audio” were not the same thing in the previous design,
|
||||
and the gap between them is audible.</p>
|
||||
</div></details><details class="toggle method-toggle" open><summary><section id="tymethod.seek" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#273">Source</a><h4 class="code-header">fn <a href="#tymethod.seek" class="fn">seek</a>(&mut self, to: <a class="struct" href="https://doc.rust-lang.org/1.97.1/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section></summary><div class="docblock"><p>Seek to an absolute position on the item’s own timeline.</p>
|
||||
<p>Whether that is an in-place seek or a re-open of the stream is the
|
||||
engine’s business: hls.js seeks within a VOD playlist, mpv’s HLS demuxer
|
||||
cannot make a server transcode from a new offset. Callers state the
|
||||
destination and nothing else.</p>
|
||||
</div></details><section id="tymethod.set_volume" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#275">Source</a><h4 class="code-header">fn <a href="#tymethod.set_volume" class="fn">set_volume</a>(&mut self, volume: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f32.html">f32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section><section id="tymethod.set_muted" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#276">Source</a><h4 class="code-header">fn <a href="#tymethod.set_muted" class="fn">set_muted</a>(&mut self, muted: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.bool.html">bool</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section><section id="tymethod.set_rate" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#277">Source</a><h4 class="code-header">fn <a href="#tymethod.set_rate" class="fn">set_rate</a>(&mut self, rate: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section><section id="tymethod.select_audio_track" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#279">Source</a><h4 class="code-header">fn <a href="#tymethod.select_audio_track" class="fn">select_audio_track</a>(&mut self, index: <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.i32.html">i32</a>>) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section><section id="tymethod.select_subtitle_track" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#280">Source</a><h4 class="code-header">fn <a href="#tymethod.select_subtitle_track" class="fn">select_subtitle_track</a>(
|
||||
&mut self,
|
||||
index: <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.i32.html">i32</a>>,
|
||||
) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section><details class="toggle method-toggle" open><summary><section id="tymethod.snapshot" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#283">Source</a><h4 class="code-header">fn <a href="#tymethod.snapshot" class="fn">snapshot</a>(&self) -> <a class="struct" href="struct.PlaybackSnapshot.html" title="struct jellytau_lib::player::media_player::PlaybackSnapshot">PlaybackSnapshot</a></h4></section></summary><div class="docblock"><p>One coherent read of the engine’s state.</p>
|
||||
</div></details><section id="tymethod.capabilities" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#285">Source</a><h4 class="code-header">fn <a href="#tymethod.capabilities" class="fn">capabilities</a>(&self) -> <a class="struct" href="struct.Capabilities.html" title="struct jellytau_lib::player::media_player::Capabilities">Capabilities</a></h4></section></div><h2 id="provided-methods" class="section-header">Provided Methods<a href="#provided-methods" class="anchor">§</a></h2><div class="methods"><details class="toggle method-toggle" open><summary><section id="method.set_audio_settings" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#292-294">Source</a><h4 class="code-header">fn <a href="#method.set_audio_settings" class="fn">set_audio_settings</a>(
|
||||
&mut self,
|
||||
_settings: &<a class="struct" href="../../settings/struct.AudioSettings.html" title="struct jellytau_lib::settings::AudioSettings">AudioSettings</a>,
|
||||
) -> <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/result/enum.Result.html" title="enum core::result::Result">Result</a><<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.unit.html">()</a>, <a class="struct" href="../backend/struct.PlayerError.html" title="struct jellytau_lib::player::backend::PlayerError">PlayerError</a>></h4></section></summary><div class="docblock"><p>Apply EQ, normalisation and gapless settings.</p>
|
||||
<p>Provided rather than required: engines that cannot honour them say so
|
||||
through <a href="struct.Capabilities.html#structfield.audio_settings" title="field jellytau_lib::player::media_player::Capabilities::audio_settings"><code>Capabilities::audio_settings</code></a> and inherit this no-op, instead
|
||||
of every implementation carrying an <code>Ok(())</code> it does not mean.</p>
|
||||
</div></details><section id="method.audio_settings" class="method"><a class="src rightside" href="../../../src/jellytau_lib/player/media_player.rs.html#296-298">Source</a><h4 class="code-header">fn <a href="#method.audio_settings" class="fn">audio_settings</a>(&self) -> <a class="struct" href="../../settings/struct.AudioSettings.html" title="struct jellytau_lib::settings::AudioSettings">AudioSettings</a></h4></section></div><h2 id="implementors" class="section-header">Implementors<a href="#implementors" class="anchor">§</a></h2><div id="implementors-list"><div class="negative-marker"></div><section id="impl-MediaPlayer-for-MpvPlayer" class="impl"><a class="src rightside" href="../../../src/jellytau_lib/player/mpv_player.rs.html#199-383">Source</a><a href="#impl-MediaPlayer-for-MpvPlayer" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.MediaPlayer.html" title="trait jellytau_lib::player::media_player::MediaPlayer">MediaPlayer</a> for <a class="struct" href="../mpv_player/struct.MpvPlayer.html" title="struct jellytau_lib::player::mpv_player::MpvPlayer">MpvPlayer</a></h3></section><section id="impl-MediaPlayer-for-LegacyPlayer%3CB%3E" class="impl"><a class="src rightside" href="../../../src/jellytau_lib/player/legacy_player.rs.html#52-154">Source</a><a href="#impl-MediaPlayer-for-LegacyPlayer%3CB%3E" class="anchor">§</a><h3 class="code-header">impl<B: <a class="trait" href="../backend/trait.PlayerBackend.html" title="trait jellytau_lib::player::backend::PlayerBackend">PlayerBackend</a> + <a class="trait" href="https://doc.rust-lang.org/1.97.1/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a>> <a class="trait" href="trait.MediaPlayer.html" title="trait jellytau_lib::player::media_player::MediaPlayer">MediaPlayer</a> for <a class="struct" href="../legacy_player/struct.LegacyPlayer.html" title="struct jellytau_lib::player::legacy_player::LegacyPlayer">LegacyPlayer</a><B></h3></section></div><script src="../../../trait.impl/jellytau_lib/player/media_player/trait.MediaPlayer.js" async></script></section></div></main></body></html>
|
||||
Reference in New Issue
Block a user