Implement suspend() and resume() for OfflineAudioContext

Source/modules/webaudio/OfflineAudioContext.h

 /*
  * Copyright (C) 2012, Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1.  Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2.  Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
@@ skipping 18 matching lines @@
 #include "modules/webaudio/AudioContext.h"
 
 namespace blink {
 
 class ExceptionState;
 
 class MODULES_EXPORT OfflineAudioContext final : public AudioContext {
     DEFINE_WRAPPERTYPEINFO();
 public:
     static OfflineAudioContext* create(ExecutionContext*, unsigned numberOfChannels, size_t numberOfFrames, float sampleRate, ExceptionState&);
-
     virtual ~OfflineAudioContext();
 
+    virtual bool suspendIfNecessary();
+    bool isSuspendScheduled() const;
+
     ScriptPromise startOfflineRendering(ScriptState*);
+    ScriptPromise suspendOfflineRendering(ScriptState*, double suspendTime);
+    ScriptPromise resumeOfflineRendering(ScriptState*);
+
 private:
     OfflineAudioContext(Document*, unsigned numberOfChannels, size_t numberOfFrames, float sampleRate);
+
+    // A container class for pairs of time information and suspend promise.
+    class ScheduledSuspendContainer : public NoBaseWillBeGarbageCollected<ScheduledSuspendContainer> {
+    public:
+        static PassOwnPtr<ScheduledSuspendContainer> create(double, PassRefPtrWillBeRawPtr<ScriptPromiseResolver>);
+        ~ScheduledSuspendContainer();
+        PassRefPtrWillBeRawPtr<ScriptPromiseResolver> resolver() { return m_resolver; }
+        bool shouldBeSuspendedNow(double currentTime) const;

[Raymond Toy, 2015/05/19 22:04:45]

Add comment on what this is supposed to do.

[hongchan, 2015/05/20 22:09:41]

Done.

+
+        DECLARE_TRACE();
+
+    private:
+        ScheduledSuspendContainer(double, PassRefPtrWillBeRawPtr<ScriptPromiseResolver>);
+
+        double m_when;
+        RefPtrWillBeMember<ScriptPromiseResolver> m_resolver;
+    };
+
+    void suspendAndResolveOnMainThread(unsigned);
+
+    // Unlike the design of real-time audio context, we keep suspend/resume

[Raymond Toy, 2015/05/19 22:04:45]

This comment is wrong now since we're not using just one. Online context only
has a list for resume.

+    // promises in separate two vectors. This is because suspend() accompanies
+    // the timing information whereas resume() resolves when it is actually
+    // called.
+    WillBeHeapVector<OwnPtrWillBeMember<ScheduledSuspendContainer>> m_scheduledSuspends;
+    WillBeHeapVector<RefPtrWillBeMember<ScriptPromiseResolver>> m_resumeResolvers;
 };
 
 } // namespace blink
 
 #endif // OfflineAudioContext_h