diff -r 000000000000 -r 6474c204b198 dom/telephony/Telephony.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/dom/telephony/Telephony.h Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,206 @@ +/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* vim: set ts=8 sts=2 et sw=2 tw=80: */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#ifndef mozilla_dom_telephony_telephony_h__ +#define mozilla_dom_telephony_telephony_h__ + +#include "mozilla/dom/BindingDeclarations.h" +#include "mozilla/dom/Promise.h" +#include "mozilla/dom/telephony/TelephonyCommon.h" + +#include "nsITelephonyProvider.h" + +// Need to include TelephonyCall.h because we have inline methods that +// assume they see the definition of TelephonyCall. +#include "TelephonyCall.h" + +class nsPIDOMWindow; + +namespace mozilla { +namespace dom { + +class OwningTelephonyCallOrTelephonyCallGroup; + +class Telephony MOZ_FINAL : public DOMEventTargetHelper +{ + /** + * Class Telephony doesn't actually inherit nsITelephonyListener. + * Instead, it owns an nsITelephonyListener derived instance mListener + * and passes it to nsITelephonyProvider. The onreceived events are first + * delivered to mListener and then forwarded to its owner, Telephony. See + * also bug 775997 comment #51. + */ + class Listener; + + class Callback; + friend class Callback; + + class EnumerationAck; + friend class EnumerationAck; + + nsCOMPtr mProvider; + nsRefPtr mListener; + + TelephonyCall* mActiveCall; + nsTArray > mCalls; + nsRefPtr mCallsList; + + nsRefPtr mGroup; + + bool mEnumerated; + +public: + NS_DECL_ISUPPORTS_INHERITED + NS_DECL_NSITELEPHONYLISTENER + NS_REALLY_FORWARD_NSIDOMEVENTTARGET(DOMEventTargetHelper) + NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(Telephony, + DOMEventTargetHelper) + + nsPIDOMWindow* + GetParentObject() const + { + return GetOwner(); + } + + // WrapperCache + virtual JSObject* + WrapObject(JSContext* aCx) MOZ_OVERRIDE; + + // WebIDL + already_AddRefed + Dial(const nsAString& aNumber, const Optional& aServiceId); + + already_AddRefed + DialEmergency(const nsAString& aNumber, const Optional& aServiceId); + + void + StartTone(const nsAString& aDTMFChar, const Optional& aServiceId, + ErrorResult& aRv); + + void + StopTone(const Optional& aServiceId, ErrorResult& aRv); + + bool + GetMuted(ErrorResult& aRv) const; + + void + SetMuted(bool aMuted, ErrorResult& aRv); + + bool + GetSpeakerEnabled(ErrorResult& aRv) const; + + void + SetSpeakerEnabled(bool aEnabled, ErrorResult& aRv); + + void + GetActive(Nullable& aValue); + + already_AddRefed + Calls() const; + + already_AddRefed + ConferenceGroup() const; + + IMPL_EVENT_HANDLER(incoming) + IMPL_EVENT_HANDLER(callschanged) + IMPL_EVENT_HANDLER(remoteheld) + IMPL_EVENT_HANDLER(remoteresumed) + + static already_AddRefed + Create(nsPIDOMWindow* aOwner, ErrorResult& aRv); + + void + AddCall(TelephonyCall* aCall) + { + NS_ASSERTION(!mCalls.Contains(aCall), "Already know about this one!"); + mCalls.AppendElement(aCall); + UpdateActiveCall(aCall, IsActiveState(aCall->CallState())); + NotifyCallsChanged(aCall); + } + + void + RemoveCall(TelephonyCall* aCall) + { + NS_ASSERTION(mCalls.Contains(aCall), "Didn't know about this one!"); + mCalls.RemoveElement(aCall); + UpdateActiveCall(aCall, false); + NotifyCallsChanged(aCall); + } + + nsITelephonyProvider* + Provider() const + { + return mProvider; + } + + const nsTArray >& + CallsArray() const + { + return mCalls; + } + + virtual void EventListenerAdded(nsIAtom* aType) MOZ_OVERRIDE; + +private: + Telephony(nsPIDOMWindow* aOwner); + ~Telephony(); + + void + Shutdown(); + + static bool + IsValidNumber(const nsAString& aNumber); + + static uint32_t + GetNumServices(); + + static bool + IsValidServiceId(uint32_t aServiceId); + + static bool + IsActiveState(uint16_t aCallState); + + uint32_t + ProvidedOrDefaultServiceId(const Optional& aServiceId); + + bool + HasDialingCall(); + + bool + MatchActiveCall(TelephonyCall* aCall); + + already_AddRefed + DialInternal(uint32_t aServiceId, const nsAString& aNumber, bool isEmergency); + + already_AddRefed + CreateNewDialingCall(uint32_t aServiceId, const nsAString& aNumber); + + nsresult + NotifyCallsChanged(TelephonyCall* aCall); + + nsresult + DispatchCallEvent(const nsAString& aType, TelephonyCall* aCall); + + void + EnqueueEnumerationAck(); + + void + UpdateActiveCall(TelephonyCall* aCall, bool aIsActive); + + already_AddRefed + GetCall(uint32_t aServiceId, uint32_t aCallIndex); + + already_AddRefed + GetOutgoingCall(); + + already_AddRefed + GetCallFromEverywhere(uint32_t aServiceId, uint32_t aCallIndex); +}; + +} // namespace dom +} // namespace mozilla + +#endif // mozilla_dom_telephony_telephony_h__