Autoplay experiment metric fixes and additions.

third_party/WebKit/Source/core/html/HTMLMediaElement.h

 /*
  * Copyright (C) 2007, 2008, 2009, 2010, 2011, 2012, 2013 Apple 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 114 matching lines @@
     bool paused() const;
     double defaultPlaybackRate() const;
     void setDefaultPlaybackRate(double);
     double playbackRate() const;
     void setPlaybackRate(double);
     void updatePlaybackRate();
     TimeRanges* played();
     TimeRanges* seekable() const;
     bool ended() const;
     bool autoplay() const;
-    enum class RecordMetricsBehavior { DoNotRecord, DoRecord };
-    bool shouldAutoplay(const RecordMetricsBehavior = RecordMetricsBehavior::DoNotRecord);
+    using RecordMetricsBehavior = AutoplayExperimentHelper::Client::RecordMetricsBehavior;
+    bool shouldAutoplay(const AutoplayExperimentHelper::Client::RecordMetricsBehavior = RecordMetricsBehavior::DoNotRecord);
     bool loop() const;
     void setLoop(bool);
     void play();
     void pause();
     void requestRemotePlayback();
     void requestRemotePlaybackControl();
 
     // statistics
     unsigned webkitAudioDecodedByteCount() const;
     unsigned webkitVideoDecodedByteCount() const;
@@ skipping 116 matching lines @@
     bool isURLAttribute(const Attribute&) const override;
     void attach(const AttachContext& = AttachContext()) override;
 
     void didMoveToNewDocument(Document& oldDocument) override;
     virtual KURL posterImageURL() const { return KURL(); }
 
     enum DisplayMode { Unknown, Poster, Video };
     DisplayMode displayMode() const { return m_displayMode; }
     virtual void setDisplayMode(DisplayMode mode) { m_displayMode = mode; }
 
+    void recordAutoplayMetric(AutoplayMetrics);
+
 private:
     void resetMediaPlayerAndMediaSource();
 
     bool alwaysCreateUserAgentShadowRoot() const final { return true; }
     bool areAuthorShadowsAllowed() const final { return false; }
 
     bool supportsFocus() const final;
     bool isMouseFocusable() const final;
     bool layoutObjectIsNeeded(const ComputedStyle&) override;
     LayoutObject* createLayoutObject(const ComputedStyle&) override;
@@ skipping 85 matching lines @@
     void deferredLoadTimerFired(Timer<HTMLMediaElement>*);
 
     void markCaptionAndSubtitleTracksAsUnconfigured();
 
     // This does not check user gesture restrictions.
     void playInternal();
 
     // This does not change the buffering strategy.
     void pauseInternal();
 
-    // If we are about to enter a paused state, call this to record
-    // autoplay metrics.  If we were already in a stopped state, then
-    // this does nothing.
-    void recordMetricsIfPausing();
-    // Could stopping at this point be considered a bailout of playback?
-    // (as in, "The user really didn't want to play this").
-    bool isBailout() const;
-    void autoplayMediaEncountered();
     void allowVideoRendering();
 
     void updateVolume();
     void updatePlayState();
     bool potentiallyPlaying() const;
     bool stoppedDueToErrors() const;
     bool couldPlayIfEnoughData() const;
 
     // Generally the presence of the loop attribute should be considered to mean playback
     // has not "ended", as "ended" and "looping" are mutually exclusive. See
@@ skipping 11 matching lines @@
     TextTrackContainer& ensureTextTrackContainer();
 
     void* preDispatchEventHandler(Event*) final;
 
     void changeNetworkStateFromLoadingToIdle();
 
     bool isAutoplaying() const { return m_autoplaying; }
 
     void setAllowHiddenVolumeControls(bool);
 
-    void recordAutoplayMetric(AutoplayMetrics);
-
     WebMediaPlayer::CORSMode corsMode() const;
 
     // Returns the "direction of playback" value as specified in the HTML5 spec.
     enum DirectionOfPlayback { Backward, Forward };
     DirectionOfPlayback directionOfPlayback() const;
 
     // Creates placeholder AudioTrack and/or VideoTrack objects when WebMemediaPlayer objects
     // advertise they have audio and/or video, but don't explicitly signal them via
     // addAudioTrack() and addVideoTrack().
     // FIXME: Remove this once all WebMediaPlayer implementations properly report their track info.
     void createPlaceholderTracksIfNecessary();
 
     // Sets the selected/enabled tracks if they aren't set before we initially
     // transition to HAVE_METADATA.
     void selectInitialTracksIfNecessary();
 
     // Return true if and only if we require a user gesture before letting
     // the media play.
     bool isUserGestureRequiredForPlay() const;
+
+    // If the user gesture is required, then this will remove it.  Note that
+    // one should not generally call this method directly; use the one on
+    // m_helper and give it a reason.
     void removeUserGestureRequirement();
-    void setInitialPlayWithoutUserGestures(bool);
 
     void setNetworkState(NetworkState);
 
     void audioTracksTimerFired(Timer<HTMLMediaElement>*);
 
     // TODO(liberato): remove once autoplay gesture override experiment concludes.
     void triggerAutoplayViewportCheckForTesting();
 
     UnthrottledTimer<HTMLMediaElement> m_loadTimer;
     UnthrottledTimer<HTMLMediaElement> m_progressEventTimer;
@@ skipping 84 matching lines @@
 
     bool m_closedCaptionsVisible : 1;
 
     bool m_havePreparedToPlay : 1;
 
     bool m_tracksAreReady : 1;
     bool m_processingPreferenceChange : 1;
     bool m_remoteRoutesAvailable : 1;
     bool m_playingRemotely : 1;
     bool m_isFinalizing : 1;
-    bool m_initialPlayWithoutUserGesture : 1;
-    bool m_autoplayMediaCounted : 1;
     // Whether this element is in overlay fullscreen mode.
     bool m_inOverlayFullscreenVideo : 1;
 
     PersistentWillBeMember<AudioTrackList> m_audioTracks;
     PersistentWillBeMember<VideoTrackList> m_videoTracks;
     PersistentWillBeMember<TextTrackList> m_textTracks;
     PersistentHeapVectorWillBeHeapVector<Member<TextTrack>> m_textTracksWhenResourceSelectionBegan;
 
     OwnPtrWillBeMember<CueTimeline> m_cueTimeline;
 
@@ skipping 49 matching lines @@
         Mutex provideInputLock;
     };
 
     AudioSourceProviderImpl m_audioSourceProvider;
 
     friend class Internals;
     friend class TrackDisplayUpdateScope;
     friend class AutoplayExperimentHelper;
     friend class MediaControlsTest;
 
-    AutoplayExperimentHelper m_autoplayHelper;
+    class AutoplayHelperClientImpl : public AutoplayExperimentHelper::Client {

[sof, 2016/02/16 08:40:06]

You need to turn this into an Oilpan controlled object --

  class AutoplayHelperClientImpl : public
NoBaseWillBeGarbageCollectedFinalized<AutoplayHelperClientImpl>, public ... {
   ....
  };

Can we move this local class to the .cpp? HTMLMediaElement.h is too bulky as it
is, so would be good if we can not extend it unnecessarily.

[liberato (no reviews please), 2016/02/24 18:44:06]

declaring this to be a subclass of NoBase... causes an "ambiguous operator new"
between this and Client::new.  i just removed the NoBase... here.  is that the
right thing to do?

+    public:
+        AutoplayHelperClientImpl(HTMLMediaElement* element) : m_element(element) {}
+        virtual ~AutoplayHelperClientImpl();
+
+        double currentTime() const override { return m_element->currentTime(); }
+        double duration() const override { return m_element->duration(); }
+        bool paused() const override { return m_element->paused(); }
+        bool muted() const override { return m_element->muted(); }
+        void setMuted(bool muted) override { m_element->setMuted(muted); }
+        void playInternal() override { m_element->playInternal(); }
+        bool isUserGestureRequiredForPlay() const override { return m_element->isUserGestureRequiredForPlay(); }
+        void removeUserGestureRequirement() override { m_element->removeUserGestureRequirement(); }
+        void recordAutoplayMetric(AutoplayMetrics metric) override { m_element->recordAutoplayMetric(metric); }
+        bool shouldAutoplay(RecordMetricsBehavior behavior) override { return m_element->shouldAutoplay(behavior); }
+        bool isHTMLVideoElement() const override { return m_element->isHTMLVideoElement(); }
+        bool isHTMLAudioElement() const override { return m_element->isHTMLAudioElement(); }
+
+        // Document
+        bool isLegacyViewportType() override;
+        PageVisibilityState pageVisibilityState() const override;
+        String autoplayExperimentMode() const override;
+
+        // LayoutObject
+        void setRequestPositionUpdates(bool) override;
+        IntRect absoluteBoundingBoxRect() const override;
+
+    private:
+        // AutoplayHelperClientImpl is destroyed by HTMLMediaElement, and is
+        // not itself GC'd.
+        RawPtrWillBeUntracedMember<HTMLMediaElement> m_element;

[sof, 2016/02/16 08:40:06]

RawPtrWillBeMember<HTMLMediaElement> + it needs to be traced.

[liberato (no reviews please), 2016/02/24 18:44:06]

Done.

+    };
+
+    OwnPtr<AutoplayExperimentHelper::Client> m_autoplayHelperClient;

[sof, 2016/02/16 08:40:06]

OwnPtrWillBeMember<..> + it needs to be traced.

[liberato (no reviews please), 2016/02/24 18:44:05]

Done.

+    OwnPtr<AutoplayExperimentHelper> m_autoplayHelper;

[sof, 2016/02/16 08:40:06]

OwnPtrWillBeMemer<AutoplayExperimentHelper> m_autoplayHelper;

[liberato (no reviews please), 2016/02/24 18:44:05]

Done.

 
     static URLRegistry* s_mediaStreamRegistry;
 };
 
 inline bool isHTMLMediaElement(const HTMLElement& element)
 {
     return isHTMLAudioElement(element) || isHTMLVideoElement(element);
 }
 
 DEFINE_HTMLELEMENT_TYPE_CASTS_WITH_FUNCTION(HTMLMediaElement);
 
 } // namespace blink
 
 #endif // HTMLMediaElement_h