blob: 33ac197e73e44e06398ccac4c23546924a1452f9 [file] [log] [blame]
// Copyright 2018 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
library fuchsia.media.playback;
using fuchsia.media;
using zx;
/// Manages sources on behalf of a Player.
protocol SourceManager {
/// Creates a source that reads from a file.
CreateFileSource(resource struct {
file_channel zx.handle:CHANNEL;
source_request server_end:Source;
});
/// Creates a source that reads from a `SeekingReader`.
CreateReaderSource(resource struct {
seeking_reader client_end:SeekingReader;
source_request server_end:Source;
});
/// Creates a source that allows the client to provide independent elementary
/// streams to the player. duration_ns, can_pause, can_seek and metadata are
/// all included in the SourceStatus and, when the `ElementarySource` is used by
/// the player, in the `PlayerStatus` as well. `can_pause` and `can_seek`, when
/// false, constrain the capabilities of the player.
CreateElementarySource(resource struct {
duration_ns zx.duration;
can_pause bool;
can_seek bool;
metadata box<fuchsia.media.Metadata>;
source_request server_end:ElementarySource;
});
/// Sets the source for this player to use. If source is null, the player
/// becomes idle.
SetSource(resource struct {
source client_end:<Source, optional>;
});
/// Transitions to the specified source when playback of the current source
/// reaches transition_pts. The new source starts playback at start_pts. If
/// a transition is already pending, it will be discarded in favor of the new
/// transition.
TransitionToSource(resource struct {
source client_end:Source;
transition_pts int64;
start_pts int64;
});
/// Cancels a pending transition, returning the source. If no transition is
/// pending, the request channel is closed.
CancelSourceTransition(resource struct {
returned_source_request server_end:Source;
});
};
/// A source of content that may be used by a player.
protocol Source {
// Provides current status immediately after binding and whenever status
// changes thereafter.
-> OnStatusChanged(struct {
source_status SourceStatus;
});
};
/// `Source` variant for providing elementary streams directly to the player.
protocol ElementarySource {
compose Source;
/// Adds an elementary stream. The elementary stream can be removed by
/// closing the `SimpleStreamSink`. `ticks_per_second_numerator` and
/// `ticks_per_second_denominator` indicate the units that will be used for
/// `Streampacket` timestamp values. For nanoseconds units, for example,
/// `ticks_per_second_numerator` should be 1000000000 and
/// `ticks_per_second_denominator` should be 1. To use units of frames for
/// 48k audio, `ticks_per_second_numerator` should be 48000 and
/// `ticks_per_second_denominator` should be 1.
//
// SimpleStreamSink methods not currently implemented:
// DiscardAllPackets
// DiscardAllPacketsNoReply
AddStream(resource struct {
type fuchsia.media.StreamType;
ticks_per_second_numerator uint32;
ticks_per_second_denominator uint32;
sink_request server_end:fuchsia.media.SimpleStreamSink;
});
/// Adds a new binding to this `ElementarySource`. By using this method,
/// the client can obtain an additional channel through which to communicate
/// to this `ElementarySource` even after a channel is consumed by a call to
/// `SourceManager.SetSource`.
// IMPLEMENTATION NOTE:
// This method is implemented, however a limitation in the current
// implementation requires that the StreamSource handle passed to
// SourceManager.SetSource be created from the connection established by the
// original CreateStreamSource call. That is, a connection established
// using AddBinding cannot be passed to SourceManager.SetSource.
// TODO(dalesat): Remove this limitation.
AddBinding(resource struct {
source_request server_end:ElementarySource;
});
};
/// Source status information.
type SourceStatus = struct {
/// Duration of the content.
duration zx.duration;
/// Whether the source can pause.
can_pause bool;
/// Whether the source can seek.
can_seek bool;
/// Whether the source has an audio stream.
has_audio bool;
/// Whether the source has a video stream.
has_video bool;
/// Indicates whether the source is ready. A true value signals that the
/// content has been probed and there are no known problems with it.
ready bool;
/// Describes the media.
metadata box<fuchsia.media.Metadata>;
/// Indicates a problem preventing intended operation. A null value
/// indicates that the source is functioning as intended.
problem box<Problem>;
};