content/public/browser/presentation_service_delegate.h

   1 // Copyright 2015 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 #ifndef CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_
   6 #define CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_
   7
   8 #include "content/common/content_export.h"
   9
  10 namespace content {
  11
  12 class PresentationScreenAvailabilityListener;
  13
  14 // An interface implemented by embedders to handle presentation API calls
  15 // forwarded from PresentationServiceImpl.
  16 class CONTENT_EXPORT PresentationServiceDelegate {
  17  public:
  18   // Observer interface to listen for changes to PresentationServiceDelegate.
  19   class CONTENT_EXPORT Observer {
  20    public:
  21     // Called when the PresentationServiceDelegate is being destroyed.
  22     virtual void OnDelegateDestroyed() = 0;
  23
  24    protected:
  25     virtual ~Observer() {}
  26   };
  27
  28   virtual ~PresentationServiceDelegate() {}
  29
  30   // Registers an observer with this class to listen for updates to this class.
  31   // This class does not own the observer.
  32   // It is an error to add an observer if it has already been added before.
  33   virtual void AddObserver(Observer* observer) = 0;
  34   // Unregisters an observer with this class.
  35   virtual void RemoveObserver(Observer* observer) = 0;
  36
  37   // Registers |listener| to continuously listen for
  38   // availability updates for a presentation URL, originated from the frame
  39   // given by |render_process_id| and |render_frame_id|.
  40   // This class does not own |listener|.
  41   // Returns true on success.
  42   // This call will return false if a listener with the same presentation URL
  43   // from the same frame is already registered.
  44   virtual bool AddScreenAvailabilityListener(
  45       int render_process_id,
  46       int render_frame_id,
  47       PresentationScreenAvailabilityListener* listener) = 0;
  48
  49   // Unregisters |listener| originated from the frame given by
  50   // |render_process_id| and |render_frame_id| from this class. The listener
  51   // will no longer receive availability updates.
  52   virtual void RemoveScreenAvailabilityListener(
  53       int render_process_id,
  54       int render_frame_id,
  55       PresentationScreenAvailabilityListener* listener) = 0;
  56
  57   // Unregisters all listeners associated with the frame given by
  58   // |render_process_id| and |render_frame_id|.
  59   virtual void RemoveAllScreenAvailabilityListeners(
  60       int render_process_id,
  61       int render_frame_id) = 0;
  62 };
  63
  64 }  // namespace content
  65
  66 #endif  // CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_