media/cast/cast_sender.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4 //
   5 // This is the main interface for the cast sender.
   6 //
   7 // The AudioFrameInput, VideoFrameInput and PacketReciever interfaces should
   8 // be accessed from the main thread.
   9
  10 #ifndef MEDIA_CAST_CAST_SENDER_H_
  11 #define MEDIA_CAST_CAST_SENDER_H_
  12
  13 #include "base/basictypes.h"
  14 #include "base/callback.h"
  15 #include "base/memory/ref_counted.h"
  16 #include "base/memory/scoped_ptr.h"
  17 #include "base/time/tick_clock.h"
  18 #include "base/time/time.h"
  19 #include "media/base/audio_bus.h"
  20 #include "media/cast/cast_config.h"
  21 #include "media/cast/cast_environment.h"
  22 #include "media/cast/net/cast_transport_sender.h"
  23
  24 namespace media {
  25 class VideoFrame;
  26
  27 namespace cast {
  28 class AudioSender;
  29 class VideoSender;
  30
  31 class VideoFrameInput : public base::RefCountedThreadSafe<VideoFrameInput> {
  32  public:
  33   // Insert video frames into Cast sender. Frames will be encoded, packetized
  34   // and sent to the network.
  35   virtual void InsertRawVideoFrame(
  36       const scoped_refptr<media::VideoFrame>& video_frame,
  37       const base::TimeTicks& capture_time) = 0;
  38
  39  protected:
  40   virtual ~VideoFrameInput() {}
  41
  42  private:
  43   friend class base::RefCountedThreadSafe<VideoFrameInput>;
  44 };
  45
  46 class AudioFrameInput : public base::RefCountedThreadSafe<AudioFrameInput> {
  47  public:
  48   // Insert audio frames into Cast sender. Frames will be encoded, packetized
  49   // and sent to the network.
  50   virtual void InsertAudio(scoped_ptr<AudioBus> audio_bus,
  51                            const base::TimeTicks& recorded_time) = 0;
  52
  53  protected:
  54   virtual ~AudioFrameInput() {}
  55
  56  private:
  57   friend class base::RefCountedThreadSafe<AudioFrameInput>;
  58 };
  59
  60 // All methods of CastSender must be called on the main thread.
  61 // Provided CastTransportSender will also be called on the main thread.
  62 class CastSender {
  63  public:
  64   static scoped_ptr<CastSender> Create(
  65       scoped_refptr<CastEnvironment> cast_environment,
  66       CastTransportSender* const transport_sender);
  67
  68   virtual ~CastSender() {}
  69
  70   // All video frames for the session should be inserted to this object.
  71   virtual scoped_refptr<VideoFrameInput> video_frame_input() = 0;
  72
  73   // All audio frames for the session should be inserted to this object.
  74   virtual scoped_refptr<AudioFrameInput> audio_frame_input() = 0;
  75
  76   // Initialize the audio stack. Must be called in order to send audio frames.
  77   // Status of the initialization will be returned on cast_initialization_cb.
  78   virtual void InitializeAudio(
  79       const AudioSenderConfig& audio_config,
  80       const CastInitializationCallback& cast_initialization_cb) = 0;
  81
  82   // Initialize the video stack. Must be called in order to send video frames.
  83   // Status of the initialization will be returned on cast_initialization_cb.
  84   virtual void InitializeVideo(
  85       const VideoSenderConfig& video_config,
  86       const CastInitializationCallback& cast_initialization_cb,
  87       const CreateVideoEncodeAcceleratorCallback& create_vea_cb,
  88       const CreateVideoEncodeMemoryCallback& create_video_encode_mem_cb) = 0;
  89
  90   // Change the target delay. This is only valid if the receiver
  91   // supports the "adaptive_target_delay" rtp extension.
  92   virtual void SetTargetPlayoutDelay(
  93       base::TimeDelta new_target_playout_delay) = 0;
  94 };
  95
  96 }  // namespace cast
  97 }  // namespace media
  98
  99 #endif  // MEDIA_CAST_CAST_SENDER_H_