initial commit

1 files changed, 184 insertions, 0 deletions

diff --git a/files/pt-br/web/api/navigator/getusermedia/index.html b/files/pt-br/web/api/navigator/getusermedia/index.html
new file mode 100644
index 0000000000..4df2f528d4
--- /dev/null
+++ b/files/pt-br/web/api/navigator/getusermedia/index.html
@@ -0,0 +1,184 @@
+---
+title: navigator.getUserMedia
+slug: Web/API/Navigator/getUserMedia
+translation_of: Web/API/Navigator/getUserMedia
+---
+<p>{{APIRef("Media Capture and Streams")}}{{deprecated_header}}</p>
+
+<p>O método Navigator.getUserMedia() atualmente esta <em>deprecated </em>(obseleto), ele é responsavel por pedir a permissão do usuário para usar até 1 dispositivo de entrada de vídeo (como câmera, ou tela compartilhada) e até 1 dispositivo de entrada de áudio (como o microfone) como fonte para o stream de mídia (pode ser representado por uma instância <code>MediaStream</code>).</p>
+
+<p>Se o usuário der permissão, a MediaStream (o <em>track</em> do video e/ou audio) , é entregue ao <em>callback </em>de sucesso, se a permissão é negada, pode ser que não haja dispositivo compatível ou alguma condição de erro aconteceu, retornando o <em>callback </em>de erro com uma instancia do objeto   {{domxref("MediaStreamError")}} , com a descrição do erro que aconteceu, se o usuário não fizer nenhuma escolha, nenhum <em>callback </em>é retornado.</p>
+
+<h2 id="Sintaxe">Sintaxe</h2>
+
+<pre class="syntaxbox">navigator.getUserMedia ( permissoes, callbackSucesso, callbackErro );</pre>
+
+<p><strong>Exemplo</strong></p>
+
+<p>Este é um exemplo de uso da função getUserMedia() com prefixos específicos dos navegadores.</p>
+
+<pre class="brush: js">navigator.getMedia = ( navigator.getUserMedia ||
+                       navigator.webkitGetUserMedia ||
+                       navigator.mozGetUserMedia ||
+                       navigator.msGetUserMedia);
+
+navigator.getMedia (
+
+   // permissoes
+   {
+      video: true,
+      audio: true
+   },
+
+   // callbackSucesso
+   function(localMediaStream) {
+      var video = document.querySelector('video');
+      video.src = window.URL.createObjectURL(localMediaStream);
+      video.onloadedmetadata = function(e) {
+         // Faz algo com o vídeo aqui.
+      };
+   },
+
+   // callbackErro
+   function(err) {
+    console.log("O seguinte erro ocorreu: " + err);
+   }
+
+);</pre>
+
+<h2 id="Parâmetros">Parâmetros</h2>
+
+<table>
+ <thead>
+  <tr>
+   <th scope="col">parâmetro</th>
+   <th scope="col">Obrigatório/ <br>
+    Opcional </th>
+   <th scope="col">Descrição</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>permissoes</td>
+   <td>Obrigatório</td>
+   <td>Os tipos de mídia habilitados no objeto LocalMediaStream enviado para a callbackSucesso.</td>
+  </tr>
+  <tr>
+   <td>callbackSucesso</td>
+   <td>Obrigatório</td>
+   <td>A função da aplicação a ser invocada para receber o objeto LocalMediaStream.</td>
+  </tr>
+  <tr>
+   <td>callbackErro</td>
+   <td>Opcional</td>
+   <td>A função a ser invocada na aplicação se a chamada a getUserMedia falhar.</td>
+  </tr>
+ </tbody>
+</table>
+
+<h3 id="permissoes">permissoes</h3>
+
+<p>O parâmetro permissoes é um objeto MediaStreamConstraints com dois membros do tipo Boolean: <code>video</code> e <code>audio</code>. Estes membros descrevem os tipos de mídia habilitados no objeto <a href="/en-US/docs/WebRTC/MediaStream_API#LocalMediaStream" title="WebRTC/MediaStream_API#LocalMediaStream">LocalMediaStream</a>. Pelo menos um destes membros deve ser especificado para que o argumento seja validado. Se um membro especificado não for suportado pelo navegador, a função getUserMedia invocará a callbackErro com o erro NOT_SUPPORTED_ERROR. Se o navegador não puder encontrar nenhuma fonte de mídia com o tipo especificado, a função getUserMedia invocará a callbackErro com o erro MANDATORY_UNSATISFIED_ERR.</p>
+
+<p>Se o valor de um membro não estiver especificado no objeto, o valor padrão deste membro será falso. Veja como configurar o objeto permissoes para obter tanto áudio como vídeo:</p>
+
+<pre>{ video: true, audio: true }</pre>
+
+<h3 id="callbackSucesso">callbackSucesso</h3>
+
+<p>A função getUserMedia invocará a função especificada em callbackSucesso com o objeto <a href="/en-US/docs/WebRTC/MediaStream_API#LocalMediaStream" title="WebRTC/MediaStream_API#LocalMediaStream">LocalMediaStream</a> que contém a fonte de mídia. Você pode associar este objeto com o elemento apropriado e trabalhar com ele, como mostrado no exemplo a seguir:</p>
+
+<pre>function(localMediaStream) {
+   var video = document.querySelector('video');
+   video.src = window.URL.createObjectURL(localMediaStream);
+   video.onloadedmetadata = function(e) {
+      // Faz algo com o vídeo aqui.
+   };
+},</pre>
+
+<h3 id="callbackErro">callbackErro</h3>
+
+<p>A função getUserMedia invocará a função especificada em callbackErro com um argumento <code>code</code>. Os códigos de erro são descritos abaixo:</p>
+
+<table>
+ <thead>
+  <tr>
+   <th scope="col">Erro</th>
+   <th scope="col">Descrição</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>PERMISSION_DENIED </td>
+   <td>O usuário não permitiu acesso a um dispositivo de mídia necessário para essa operação. </td>
+  </tr>
+  <tr>
+   <td>NOT_SUPPORTED_ERROR </td>
+   <td>Uma mídia especificada não é suportada pelo navegador.</td>
+  </tr>
+  <tr>
+   <td>MANDATORY_UNSATISFIED_ERROR </td>
+   <td>Nenhuma fonte de mídia do tipo especificado foi encontrada.</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilidade_de_navegadores">Compatibilidade de navegadores</h2>
+
+<div>{{CompatibilityTable}}</div>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Funcionalidade</th>
+   <th>Chrome</th>
+   <th>Firefox (Gecko)</th>
+   <th>Internet Explorer</th>
+   <th>Opera</th>
+   <th>Safari (WebKit)</th>
+  </tr>
+  <tr>
+   <td>Stream API </td>
+   <td>21{{property_prefix("webkit")}} </td>
+   <td>20{{property_prefix("moz")}} </td>
+   <td>{{CompatNo}} </td>
+   <td>12</td>
+   <td>{{CompatUnknown}} </td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Funcionalidade</th>
+   <th>Android</th>
+   <th>Firefox Mobile (Gecko)</th>
+   <th>IE Phone</th>
+   <th>Opera Mobile</th>
+   <th>Safari Mobile</th>
+  </tr>
+  <tr>
+   <td>Stream API </td>
+   <td>{{CompatNo}} </td>
+   <td>{{CompatNo}}</td>
+   <td>{{CompatUnknown}} </td>
+   <td>12</td>
+   <td>{{CompatNo}} </td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<p><span style="line-height: 1.5em;">Atualmente, usar o WebRTC para acessar a câmera de vídeo é suportado nos navegadores Chrome, Opera e Firefox 20.</span></p>
+
+<h2 id="Veja_também">Veja também</h2>
+
+<ul>
+ <li><a href="/en-US/docs/WebRTC" title="WebRTC">WebRTC</a> - a página introdutória a API</li>
+ <li><a href="/en-US/docs/WebRTC/MediaStream_API" title="WebRTC/MediaStream_API">MediaStream API</a> - a API para objetos de fonte de mídia</li>
+ <li><a href="/en-US/docs/WebRTC/taking_webcam_photos" title="WebRTC/taking_webcam_photos">Taking webcam photos</a> - um tutorial sobre como usar a getUserMedia()</li>
+</ul>