[PPAPI] Pepper MediaStream API audio track implementation and example.

content/renderer/pepper/pepper_media_stream_audio_track_host.h

Index: content/renderer/pepper/pepper_media_stream_audio_track_host.h
diff --git a/content/renderer/pepper/pepper_media_stream_audio_track_host.h b/content/renderer/pepper/pepper_media_stream_audio_track_host.h
new file mode 100644
index 0000000000000000000000000000000000000000..fd87062b7ec8cb3392498dfe3e0df4eeb224d68e
--- /dev/null
+++ b/content/renderer/pepper/pepper_media_stream_audio_track_host.h
@@ -0,0 +1,103 @@
+// Copyright (c) 2014 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.
+
+#ifndef CONTENT_RENDERER_PEPPER_PEPPER_MEDIA_STREAM_AUDIO_TRACK_HOST_H_
+#define CONTENT_RENDERER_PEPPER_PEPPER_MEDIA_STREAM_AUDIO_TRACK_HOST_H_
+
+#include "base/atomicops.h"
+#include "base/compiler_specific.h"
+#include "base/memory/scoped_ptr.h"
+#include "base/memory/weak_ptr.h"
+#include "content/public/renderer/media_stream_audio_sink.h"
+#include "content/renderer/pepper/pepper_media_stream_track_host_base.h"
+#include "media/audio/audio_parameters.h"
+#include "third_party/WebKit/public/platform/WebMediaStreamTrack.h"
+
+namespace base {
+class MessageLoopProxy;
+}  // namespace base
+
+namespace content {
+
+class PepperMediaStreamAudioTrackHost : public PepperMediaStreamTrackHostBase {
+ public:
+  PepperMediaStreamAudioTrackHost(RendererPpapiHost* host,
+                                  PP_Instance instance,
+                                  PP_Resource resource,
+                                  const blink::WebMediaStreamTrack& track);
+
+ private:
+  // A helper class for receiving audio samples in the audio thread.
+  class AudioSink : public MediaStreamAudioSink,
+                    public base::SupportsWeakPtr<AudioSink> {
+   public:
+    // This class is created and destroyed in the plugin main thread.

[bbudge, 2014/01/31 20:29:35]

s/in/on

[Peng, 2014/01/31 21:09:25]

Done.

+    explicit AudioSink(PepperMediaStreamAudioTrackHost* host);
+    virtual ~AudioSink();
+
+    // Enquque a frame in the main thread.

[bbudge, 2014/01/31 20:29:35]

s/Enquque/Enqueue
s/in/on

[Peng, 2014/01/31 21:09:25]

Removed 'in the main thread', because I added a lock in AudioSink, so it is
thread safe now.

+    void EnqueueFrame(int32_t index);
+
+   private:
+    void InitFramesOnMainThread(uint32_t number_of_frames, uint32_t frame_size);
+
+    // MediaStreamAudioSink overrides:
+    // Those functions are called from the audio thread.

[bbudge, 2014/01/31 20:29:35]

// These functions should be called on the audio thread.

[Peng, 2014/01/31 21:09:25]

Done.

+    virtual void OnData(const int16* audio_data,
+                        int sample_rate,
+                        int number_of_channels,
+                        int number_of_frames) OVERRIDE;
+    virtual void OnSetFormat(const media::AudioParameters& params) OVERRIDE;
+
+    // Unowned host which is available during the AudioSink's lifespan.
+    PepperMediaStreamAudioTrackHost* host_;
+
+    // Timestamp of the next received audio frame.
+    // It is accessed in the audio thread.

[bbudge, 2014/01/31 20:29:35]

// Access only on the audio thread.
and below.

[Peng, 2014/01/31 21:09:25]

Done.

+    base::TimeDelta timestamp_;
+
+    // Duration of one audio frame.
+    // It is accessed in the audio thread.
+    base::TimeDelta frame_duration_;
+
+    // It is accessed in the audio thread.
+    media::AudioParameters audio_params_;
+
+    // The size of a frame in bytes.
+    // It is accessed in the audio thread.
+    uint32_t frame_data_size_;
+
+    // Free frames can be used for sending audio samples.
+    // Each bit of |frames_| represents a frame index.
+    base::subtle::Atomic64 frames_;
+
+    scoped_refptr<base::MessageLoopProxy> main_message_loop_proxy_;
+
+    DISALLOW_COPY_AND_ASSIGN(AudioSink);
+  };
+
+  virtual ~PepperMediaStreamAudioTrackHost();
+
+  // PepperMediaStreamTrackHostBase overrides:
+  virtual void OnClose() OVERRIDE;
+
+  // MediaStreamFrameBuffer::Delegate overrides:
+  virtual void OnNewFrameEnqueued() OVERRIDE;
+
+  // ResourceHost overrides:
+  virtual void DidConnectPendingHostToResource() OVERRIDE;
+
+  blink::WebMediaStreamTrack track_;
+
+  // True if it has been added to |blink::WebMediaStreamTrack| as a sink.

[bbudge, 2014/01/31 20:29:35]

it is a ambiguous here. Is it the host or the AudioSink?

[Peng, 2014/01/31 21:09:25]

Done.

+  bool connected_;
+
+  AudioSink audio_sink_;
+
+  DISALLOW_COPY_AND_ASSIGN(PepperMediaStreamAudioTrackHost);
+};
+
+}  // namespace content
+
+#endif  // CONTENT_RENDERER_PEPPER_PEPPER_MEDIA_STREAM_AUDIO_TRACK_HOST_H_