media/cast/cast_receiver.h

// 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.
//
// This is the main interface for the cast receiver. All configuration are done
// at creation.

#ifndef MEDIA_CAST_CAST_RECEIVER_H_
#define MEDIA_CAST_CAST_RECEIVER_H_

#include "base/basictypes.h"
#include "base/callback.h"
#include "base/memory/ref_counted.h"
#include "base/memory/scoped_ptr.h"
#include "base/time/time.h"
#include "media/cast/cast_config.h"
#include "media/cast/cast_thread.h"

namespace media {
namespace cast {
// Callback in which the raw audio frame and render time will be returned
// once decoding is complete.
typedef base::Callback<void(scoped_ptr<PcmAudioFrame>,
    const base::TimeTicks)> AudioFrameDecodedCallback;

// Callback in which the raw frame and render time will be returned once
// decoding is complete.
typedef base::Callback<void(scoped_ptr<I420VideoFrame>,
    const base::TimeTicks)> VideoFrameDecodedCallback;

// This Class is thread safe.
class FrameReceiver : public base::RefCountedThreadSafe<FrameReceiver>{
 public:
  virtual bool GetRawVideoFrame(const VideoFrameDecodedCallback& callback) = 0;

  virtual bool GetEncodedVideoFrame(EncodedVideoFrame* video_frame,
                                    base::TimeTicks* render_time) = 0;

  virtual void ReleaseEncodedVideoFrame(uint8 frame_id) = 0;

  virtual bool GetRawAudioFrame(int number_of_10ms_blocks,
                                int desired_frequency,
                                const AudioFrameDecodedCallback callback) = 0;

  virtual bool GetCodedAudioFrame(EncodedAudioFrame* audio_frame,
                                  base::TimeTicks* playout_time) = 0;

  virtual void ReleaseCodedAudioFrame(uint8 frame_id) = 0;

  virtual ~FrameReceiver() {}
};

// This Class is thread safe.
class CastReceiver {
 public:
  static CastReceiver* CreateCastReceiver(
      scoped_refptr<CastThread> cast_thread,
      const AudioReceiverConfig& audio_config,
      const VideoReceiverConfig& video_config,
      PacketSender* const packet_sender);

  // All received RTP and RTCP packets for the call should be inserted to this
  // PacketReceiver.
  virtual scoped_refptr<PacketReceiver> packet_receiver() = 0;

  // Polling interface to get audio and video frames from the CastReceiver.
  virtual scoped_refptr<FrameReceiver> frame_receiver() = 0;

  virtual ~CastReceiver() {};
};

}  // namespace cast
}  // namespace media

#endif  // MEDIA_CAST_CAST_RECEIVER_H_