Coverage Report

Created: 2018-09-25 14:53

/src/mozilla-central/dom/media/imagecapture/ImageCapture.cpp
Line
Count
Source (jump to first uncovered line)
1
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2
/* vim:set ts=2 sw=2 sts=2 et cindent: */
3
/* This Source Code Form is subject to the terms of the Mozilla Public
4
 * License, v. 2.0. If a copy of the MPL was not distributed with this
5
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6
7
#include "ImageCapture.h"
8
#include "mozilla/dom/BlobEvent.h"
9
#include "mozilla/dom/DOMException.h"
10
#include "mozilla/dom/Event.h"
11
#include "mozilla/dom/File.h"
12
#include "mozilla/dom/ImageCaptureError.h"
13
#include "mozilla/dom/ImageCaptureErrorEvent.h"
14
#include "mozilla/dom/ImageCaptureErrorEventBinding.h"
15
#include "mozilla/dom/VideoStreamTrack.h"
16
#include "nsIDocument.h"
17
#include "CaptureTask.h"
18
#include "MediaEngineSource.h"
19
20
namespace mozilla {
21
22
LogModule* GetICLog()
23
0
{
24
0
  static LazyLogModule log("ImageCapture");
25
0
  return log;
26
0
}
27
28
namespace dom {
29
30
NS_IMPL_CYCLE_COLLECTION_INHERITED(ImageCapture, DOMEventTargetHelper,
31
                                   mVideoStreamTrack)
32
33
0
NS_INTERFACE_MAP_BEGIN_CYCLE_COLLECTION(ImageCapture)
34
0
NS_INTERFACE_MAP_END_INHERITING(DOMEventTargetHelper)
35
36
NS_IMPL_ADDREF_INHERITED(ImageCapture, DOMEventTargetHelper)
37
NS_IMPL_RELEASE_INHERITED(ImageCapture, DOMEventTargetHelper)
38
39
ImageCapture::ImageCapture(VideoStreamTrack* aVideoStreamTrack,
40
                           nsPIDOMWindowInner* aOwnerWindow)
41
  : DOMEventTargetHelper(aOwnerWindow)
42
0
{
43
0
  MOZ_ASSERT(aOwnerWindow);
44
0
  MOZ_ASSERT(aVideoStreamTrack);
45
0
46
0
  mVideoStreamTrack = aVideoStreamTrack;
47
0
}
48
49
ImageCapture::~ImageCapture()
50
0
{
51
0
  MOZ_ASSERT(NS_IsMainThread());
52
0
}
53
54
already_AddRefed<ImageCapture>
55
ImageCapture::Constructor(const GlobalObject& aGlobal,
56
                          VideoStreamTrack& aTrack,
57
                          ErrorResult& aRv)
58
0
{
59
0
  nsCOMPtr<nsPIDOMWindowInner> win = do_QueryInterface(aGlobal.GetAsSupports());
60
0
  if (!win) {
61
0
    aRv.Throw(NS_ERROR_FAILURE);
62
0
    return nullptr;
63
0
  }
64
0
65
0
  RefPtr<ImageCapture> object = new ImageCapture(&aTrack, win);
66
0
67
0
  return object.forget();
68
0
}
69
70
VideoStreamTrack*
71
ImageCapture::GetVideoStreamTrack() const
72
0
{
73
0
  return mVideoStreamTrack;
74
0
}
75
76
nsresult
77
ImageCapture::TakePhotoByMediaEngine()
78
0
{
79
0
  // Callback for TakPhoto(), it also monitor the principal. If principal
80
0
  // changes, it returns PHOTO_ERROR with security error.
81
0
  class TakePhotoCallback : public MediaEnginePhotoCallback,
82
0
                            public PrincipalChangeObserver<MediaStreamTrack>
83
0
  {
84
0
  public:
85
0
    TakePhotoCallback(VideoStreamTrack* aVideoTrack, ImageCapture* aImageCapture)
86
0
      : mVideoTrack(aVideoTrack)
87
0
      , mImageCapture(aImageCapture)
88
0
      , mPrincipalChanged(false)
89
0
    {
90
0
      MOZ_ASSERT(NS_IsMainThread());
91
0
      mVideoTrack->AddPrincipalChangeObserver(this);
92
0
    }
93
0
94
0
    void PrincipalChanged(MediaStreamTrack* aMediaStream) override
95
0
    {
96
0
      mPrincipalChanged = true;
97
0
    }
98
0
99
0
    nsresult PhotoComplete(already_AddRefed<Blob> aBlob) override
100
0
    {
101
0
      RefPtr<Blob> blob = aBlob;
102
0
103
0
      if (mPrincipalChanged) {
104
0
        return PhotoError(NS_ERROR_DOM_SECURITY_ERR);
105
0
      }
106
0
      return mImageCapture->PostBlobEvent(blob);
107
0
    }
108
0
109
0
    nsresult PhotoError(nsresult aRv) override
110
0
    {
111
0
      return mImageCapture->PostErrorEvent(ImageCaptureError::PHOTO_ERROR, aRv);
112
0
    }
113
0
114
0
  protected:
115
0
    ~TakePhotoCallback()
116
0
    {
117
0
      MOZ_ASSERT(NS_IsMainThread());
118
0
      mVideoTrack->RemovePrincipalChangeObserver(this);
119
0
    }
120
0
121
0
    RefPtr<VideoStreamTrack> mVideoTrack;
122
0
    RefPtr<ImageCapture> mImageCapture;
123
0
    bool mPrincipalChanged;
124
0
  };
125
0
126
0
  RefPtr<MediaEnginePhotoCallback> callback =
127
0
    new TakePhotoCallback(mVideoStreamTrack, this);
128
0
  return mVideoStreamTrack->GetSource().TakePhoto(callback);
129
0
}
130
131
void
132
ImageCapture::TakePhoto(ErrorResult& aResult)
133
0
{
134
0
  // According to spec, VideoStreamTrack.readyState must be "live"; however
135
0
  // gecko doesn't implement it yet (bug 910249). Instead of readyState, we
136
0
  // check VideoStreamTrack.enable before bug 910249 is fixed.
137
0
  // The error code should be INVALID_TRACK, but spec doesn't define it in
138
0
  // ImageCaptureError. So it returns PHOTO_ERROR here before spec updates.
139
0
  if (!mVideoStreamTrack->Enabled()) {
140
0
    PostErrorEvent(ImageCaptureError::PHOTO_ERROR, NS_ERROR_FAILURE);
141
0
    return;
142
0
  }
143
0
144
0
  // Try if MediaEngine supports taking photo.
145
0
  nsresult rv = TakePhotoByMediaEngine();
146
0
147
0
  // It falls back to MediaStreamGraph image capture if MediaEngine doesn't
148
0
  // support TakePhoto().
149
0
  if (rv == NS_ERROR_NOT_IMPLEMENTED) {
150
0
    IC_LOG("MediaEngine doesn't support TakePhoto(), it falls back to MediaStreamGraph.");
151
0
    RefPtr<CaptureTask> task = new CaptureTask(this);
152
0
153
0
    // It adds itself into MediaStreamGraph, so ImageCapture doesn't need to hold
154
0
    // the reference.
155
0
    task->AttachTrack();
156
0
  }
157
0
}
158
159
nsresult
160
ImageCapture::PostBlobEvent(Blob* aBlob)
161
0
{
162
0
  MOZ_ASSERT(NS_IsMainThread());
163
0
  if (!CheckPrincipal()) {
164
0
    // Media is not same-origin, don't allow the data out.
165
0
    return PostErrorEvent(ImageCaptureError::PHOTO_ERROR, NS_ERROR_DOM_SECURITY_ERR);
166
0
  }
167
0
168
0
  BlobEventInit init;
169
0
  init.mBubbles = false;
170
0
  init.mCancelable = false;
171
0
  init.mData = aBlob;
172
0
173
0
  RefPtr<BlobEvent> blob_event =
174
0
    BlobEvent::Constructor(this, NS_LITERAL_STRING("photo"), init);
175
0
176
0
  return DispatchTrustedEvent(blob_event);
177
0
}
178
179
nsresult
180
ImageCapture::PostErrorEvent(uint16_t aErrorCode, nsresult aReason)
181
0
{
182
0
  MOZ_ASSERT(NS_IsMainThread());
183
0
  nsresult rv = CheckInnerWindowCorrectness();
184
0
  NS_ENSURE_SUCCESS(rv, rv);
185
0
186
0
  nsString errorMsg;
187
0
  if (NS_FAILED(aReason)) {
188
0
    nsCString name, message;
189
0
    rv = NS_GetNameAndMessageForDOMNSResult(aReason, name, message);
190
0
    if (NS_SUCCEEDED(rv)) {
191
0
      CopyASCIItoUTF16(message, errorMsg);
192
0
    }
193
0
  }
194
0
195
0
  RefPtr<ImageCaptureError> error =
196
0
    new ImageCaptureError(this, aErrorCode, errorMsg);
197
0
198
0
  ImageCaptureErrorEventInit init;
199
0
  init.mBubbles = false;
200
0
  init.mCancelable = false;
201
0
  init.mImageCaptureError = error;
202
0
203
0
  RefPtr<Event> event =
204
0
    ImageCaptureErrorEvent::Constructor(this, NS_LITERAL_STRING("error"), init);
205
0
206
0
  return DispatchTrustedEvent(event);
207
0
}
208
209
bool
210
ImageCapture::CheckPrincipal()
211
0
{
212
0
  MOZ_ASSERT(NS_IsMainThread());
213
0
214
0
  nsCOMPtr<nsIPrincipal> principal = mVideoStreamTrack->GetPrincipal();
215
0
216
0
  if (!GetOwner()) {
217
0
    return false;
218
0
  }
219
0
  nsCOMPtr<nsIDocument> doc = GetOwner()->GetExtantDoc();
220
0
  if (!doc || !principal) {
221
0
    return false;
222
0
  }
223
0
224
0
  bool subsumes;
225
0
  if (NS_FAILED(doc->NodePrincipal()->Subsumes(principal, &subsumes))) {
226
0
    return false;
227
0
  }
228
0
229
0
  return subsumes;
230
0
}
231
232
} // namespace dom
233
} // namespace mozilla