blob: 3061d6427f5061e4d6c3b3e3f855c1321734f20a [file] [log] [blame]
// Copyright 2013 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include <string>
#include "base/callback.h"
#include "base/memory/ref_counted.h"
#include "base/time/time.h"
#include "media/base/output_device_info.h"
#include "url/origin.h"
namespace content {
class MediaStreamAudioRenderer
: public base::RefCountedThreadSafe<MediaStreamAudioRenderer> {
// Starts rendering audio.
virtual void Start() = 0;
// Stops rendering audio.
virtual void Stop() = 0;
// Resumes rendering audio after being paused.
virtual void Play() = 0;
// Temporarily suspends rendering audio. The audio stream might still be
// active but new audio data is not provided to the consumer.
virtual void Pause() = 0;
// Sets the output volume.
virtual void SetVolume(float volume) = 0;
// Returns current output device information. If the information is not
// available yet, this method may block until it becomes available.
// If the renderer is not associated with any output device, |device_status|
// of OutputDeviceInfo should be set to OUTPUT_DEVICE_STATUS_ERROR_INTERNAL.
// Must never be called on the IO thread.
virtual media::OutputDeviceInfo GetOutputDeviceInfo() = 0;
// Attempts to switch the audio output device.
// Once the attempt is finished, |callback| is invoked with the result of the
// operation passed as a parameter. The result is a value from the
// media::OutputDeviceStatus enum.
// There is no guarantee about the thread where |callback| will be invoked.
// TODO(olka): make sure callback is always called on the client thread,
// update clients accordingly and fix the comment.
virtual void SwitchOutputDevice(
const std::string& device_id,
const url::Origin& security_origin,
const media::OutputDeviceStatusCB& callback) = 0;
// Time stamp that reflects the current render time. Should not be updated
// when paused.
virtual base::TimeDelta GetCurrentRenderTime() const = 0;
// Returns true if the implementation is a local renderer and false
// otherwise.
virtual bool IsLocalRenderer() const = 0;
friend class base::RefCountedThreadSafe<MediaStreamAudioRenderer>;
virtual ~MediaStreamAudioRenderer() {}
} // namespace content