diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
commit | 074785cea106179cb3305637055ab0a009ca74f2 (patch) | |
tree | e6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/pt-br/archive/b2g_os/api | |
parent | da78a9e329e272dedb2400b79a3bdeebff387d47 (diff) | |
download | translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2 translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip |
initial commit
Diffstat (limited to 'files/pt-br/archive/b2g_os/api')
6 files changed, 545 insertions, 0 deletions
diff --git a/files/pt-br/archive/b2g_os/api/alarm_api/index.html b/files/pt-br/archive/b2g_os/api/alarm_api/index.html new file mode 100644 index 0000000000..3d8c5edb3c --- /dev/null +++ b/files/pt-br/archive/b2g_os/api/alarm_api/index.html @@ -0,0 +1,173 @@ +--- +title: Alarme API +slug: Archive/B2G_OS/API/Alarm_API +tags: + - B2G + - Firefox OS + - WebAPI + - alarm +translation_of: Archive/B2G_OS/API/Alarm_API +--- +<p>{{ SeeCompatTable() }}</p> + +<h2 id="Resumo">Resumo</h2> + +<p>A API de Alarme provê acesso à configuração de alarmes do dispositivo, com a qual se pode programar notificações ou aplicações para que se iniciem em um momento específico. Porexemplo, algumas aplicações, como o despertador, calendário ou atualizações automáticas utilizam essa API para ativar comportamentos específicos do dispositivo no momento indicado.</p> + +<p>Por si só, a API de alarme permite apenas programar os alarmes. Um alarme é enviado para as aplicações através da API de mensagem do sistema, então as aplicações que precisam acionar os alarmes novamente precisam se registrar nas mensagens de alarme.</p> + +<p>Os alarmes são estabelecidos usando o objeto {{domxref("window.navigator.mozAlarms")}} que é uma instância de {{domxref("MozAlarmsManager")}}.</p> + +<h2 id="example" name="example">Programar Alarmes</h2> + +<p>A primeira a fazer quando se utiliza o alarme é progrmá-lo. Existem dois tipos de alarme baseados nos fusos-horários. Em ambos os casos é utilizado o método {{domxref("MozAlarmsManager.add")}}.</p> + +<div class="note"> +<p><strong>Nota:</strong> Se um alarme não é apontado para uma aplicação específica, o sistema poderá enviá-lo a todas as aplicações que escutam os alarmes.</p> +</div> + +<h3 id="Alarmes_ignorando_os_fusos-horários">Alarmes ignorando os fusos-horários</h3> + +<p>Esse tipo de alarme é enviado baseado na hora do dispositivo. Se o usuário muda o fuso-horário, o alarme será enviado baseado no novo fuso-horário. Por exemplo, se um usuário está em Paris e configura um alarme que deverá ser enviado às 12PM CET (hora da europa central) e o usuário viaja para San Francisco, o alarme será enviado às 12 PM PDT (hora do pacífico).</p> + +<pre class="brush: js">// Data e hora programada para o alarme +var myDate = new Date("May 15, 2012 16:20:00"); + +// Informação passada com o alarme +var data = { + foo: "bar" +} + +// A string "ignoreTimezone" é o que faz o alarme ignorar isso +var request = navigator.mozAlarms.add(myDate, "ignoreTimezone", data); + +request.onsuccess = function () { + console.log("O alarme foi programado"); +}; + +request.onerror = function () { + console.log("Ocorreu um erro: " + this.error.name); +}; +</pre> + +<h3 id="Alarmes_respeitando_os_fusos-horários">Alarmes respeitando os fusos-horários</h3> + +<p>Esse tipo de alarme é enviado baseado no fuso-horário definido quando o alarme foi programado. Se por alguma razão o usuário do dispositivo mudar seu fuso-horário, o alarme será enviado com base no fuso-horário original. Por exemplo, se um usuário está em Paris e programa um alarme que deveria ser enviado às 12 PM CET (hora da europa central) e se o usuário viaja para San Francisco, o alarme será enviado às 3 AM PDT (hora do pacífico).</p> + +<pre class="brush: js">// Data e hora do alarme +var myDate = new Date("May 15, 2012 16:20:00"); + +// Informação passada com o alarme +var data = { + foo: "bar" +} + +// A string "honorTimezone" fará com que o alarme respeite o fuso-horário +var request = navigator.mozAlarms.add(myDate, "honorTimezone", data); + +request.onsuccess = function () { + console.log("O alarme foi programado"); +}; + +request.onerror = function () { + console.log("Ocorreu um erro: " + this.error.name); +}; +</pre> + +<h2 id="Gerenciando_os_alarmes">Gerenciando os alarmes</h2> + +<p>Uma vez um alarme é programado, é possível gerenciá-lo.</p> + +<p>O método {{domxref("MozAlarmsManager.getAll")}} retornará a lista completa de alarmes atualmente programados pela aplicação.. Essa lista é um <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" title="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a></code> de objetos {{Anch("mozAlarm")}}.</p> + +<h3 id="mozAlarm">mozAlarm</h3> + +<p>{{page("/pt-BR/docs/Web/API/MozAlarmsManager.getAll","mozAlarm")}}</p> + +<pre class="brush: js">var request = navigator.mozAlarms.getAll(); + +request.onsuccess = function () { + this.result.forEach(function (alarm) { + console.log('Id: ' + alarm.id); + console.log('date: ' + alarm.date); + console.log('respectTimezone: ' + alarm.respectTimezone); + console.log('data: ' + JSON.stringify(alarm.data)); + }); +}; + +request.onerror = function () { + console.log("An error occurred: " + this.error.name); +}; +</pre> + +<p>O método {{domxref("MozAlarmsManager.remove")}} é utilizado para desprogramar um alarme já programado, ou seja, removê-lo.</p> + +<pre class="brush: js">var alarmId; + +// Programa um alarme e obtém o ID do mesmo +var request = navigator.mozAlarms.add(new Date("May 15, 2012 16:20:00"), "honorTimezone"); + +request.onsuccess = function () { + alarmId = this.result; +} + +// ... + +// Remove o alarme se ele existir +if (alarmId) { + navigator.mozAlarms.remove(alarmId); +} +</pre> + +<h2 id="Manipulação_de_alarmes">Manipulação de alarmes</h2> + +<p>Qualquer aplicação pode ser reativada quando um alarme é programado pelo sistema. Com a finalidade de ser capaz de manipular alarmes, uma aplicação deve ser registrada como manipuladora de alarmes. Isto é feito através da API de mensagens do sistema, em dois passos:</p> + +<p>Primeiro, as aplicações deverão incluir alarm na propriedade de mensagens, no manifesto da aplicação, com a URL do documento que registra a função de retorno (callback) que será usada quando o alarme for enviado.</p> + +<pre class="brush: js">"messages": [ + { "alarm": "/index.html" } +]</pre> + +<p>Segundo, a aplicação deve linkar a função de retorno com a mensagem de alarm. Isso [e feito utilizando o método {{domxref("window.navigator.mozSetMessageHandler","navigator.mozSetMessageHandler")}}. Essa função receberá o objeto {{Anch("mozAlarm")}} contendo a informação do alarme.</p> + +<pre class="brush: js">navigator.mozSetMessageHandler("alarm", function (mozAlarm) { + alert("alarm fired: " + JSON.stringify(mozAlarm.data)); +}); +</pre> + +<p>Se uma aplicação deseja saber se existe um alarme pendente a nível de sistema, é possível utilizar o método {{domxref("window.navigator.mozHasPendingMessage","navigator.mozHasPendingMessage")}} com o valor <code>alarm</code>.</p> + +<pre class="brush: js">navigator.mozHasPendingMessage("alarm"); +</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Status</th> + <th scope="col">Comentário</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('Alarm API')}}</td> + <td>{{Spec2('Alarm API')}}</td> + <td>Especificação inicial.</td> + </tr> + </tbody> +</table> + +<h2 id="Navegadores_compatíveis">Navegadores compatíveis</h2> + +<p>Supported in Firefox OS 1.0.1.</p> + +<h2 id="Veja_mais">Veja mais</h2> + +<ul> + <li>{{domxref("window.navigator.mozAlarms","navigator.mozAlarms")}}</li> + <li>{{domxref("MozAlarmsManager")}}</li> + <li>{{domxref("window.navigator.mozSetMessageHandler")}}</li> +</ul> diff --git a/files/pt-br/archive/b2g_os/api/index.html b/files/pt-br/archive/b2g_os/api/index.html new file mode 100644 index 0000000000..d71360a2fa --- /dev/null +++ b/files/pt-br/archive/b2g_os/api/index.html @@ -0,0 +1,14 @@ +--- +title: B2G OS APIs +slug: Archive/B2G_OS/API +tags: + - API + - B2G API + - NeedsTranslation + - TopicStub + - b2g os api's +translation_of: Archive/B2G_OS/API +--- +<p id="B2G_OS_uses_standard_Web_API's">List of B2G OS APIs</p> + +<p>{{APIListAlpha('/en-US/docs/Archive/B2G_OS/API')}}</p> diff --git a/files/pt-br/archive/b2g_os/api/mozalarmsmanager/index.html b/files/pt-br/archive/b2g_os/api/mozalarmsmanager/index.html new file mode 100644 index 0000000000..fde010c8bd --- /dev/null +++ b/files/pt-br/archive/b2g_os/api/mozalarmsmanager/index.html @@ -0,0 +1,127 @@ +--- +title: MozAlarmsManager +slug: Archive/B2G_OS/API/MozAlarmsManager +tags: + - API + - B2G + - Firefox OS + - NeedsTranslation + - Non-standard + - Reference + - TopicStub + - WebAPI + - alarm +translation_of: Archive/B2G_OS/API/MozAlarmsManager +--- +<p>{{APIRef("Firefox OS")}}</p> + +<p>{{ non-standard_header() }}</p> + +<p>{{ B2GOnlyHeader2('installed') }}</p> + +<h2 id="Summary">Summary</h2> + +<p>The <code>MozAlarmsManager</code> API allows to schedule notifications or applications to be started at a specific time.</p> + +<h2 id="Interface_overview">Interface overview</h2> + +<pre>interface MozAlarmsManager +{ + DOMRequest getAll(); + DOMRequest add(Date date, DOMString respectTimezone, optional object data); + void remove(unsigned long id); +};</pre> + +<h2 id="Properties">Properties</h2> + +<p>None.</p> + +<h2 id="Methods">Methods</h2> + +<dl> + <dt>{{ domxref("MozAlarmsManager.getAll()") }}</dt> + <dd>Gets the list of all alarms currently scheduled.</dd> + <dt>{{ domxref("MozAlarmsManager.add()") }}</dt> + <dd>Allows to schedule a new alarm.</dd> + <dt>{{ domxref("MozAlarmsManager.remove()") }}</dt> + <dd>Allows to remove an existing alarm.</dd> +</dl> + +<h2 id="Specification">Specification</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{ SpecName('Alarm API', '#interface-alarmmanager') }}</td> + <td>{{ Spec2('Alarm API') }}</td> + <td>Defines the <code>AlarmManager</code> interface.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Firefox OS</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatNo()}}</td> + <td>1.0</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + </tr> + </tbody> +</table> +</div> + +<h3 id="Gecko_implementation_note">Gecko implementation note</h3> + +<p>This API is currently available on Firefox OS only for any installed applications. The current specification for this API is not considered stable enough to unprefix the API yet.</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("navigator.mozAlarms")}}</li> +</ul> diff --git a/files/pt-br/archive/b2g_os/api/mozalarmsmanager/mozalarmsmanager.getall/index.html b/files/pt-br/archive/b2g_os/api/mozalarmsmanager/mozalarmsmanager.getall/index.html new file mode 100644 index 0000000000..32e4e66793 --- /dev/null +++ b/files/pt-br/archive/b2g_os/api/mozalarmsmanager/mozalarmsmanager.getall/index.html @@ -0,0 +1,140 @@ +--- +title: MozAlarmsManager.getAll +slug: Archive/B2G_OS/API/MozAlarmsManager/MozAlarmsManager.getAll +tags: + - API + - Firefox OS + - Reference + - WebAPI + - alarm +translation_of: Archive/B2G_OS/API/MozAlarmsManager/getAll +--- +<p>{{APIRef("Firefox OS")}}{{ non-standard_header() }}</p> + +<p>{{ B2GOnlyHeader2('installed') }}</p> + +<h2 id="Resumo">Resumo</h2> + +<p>O método <code>getAll</code> é utilizado para retornar uma lista dos alarmes pendentes.</p> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre>var request = navigator.mozAlarms.getAll();</pre> + +<h3 id="Retorno">Retorno</h3> + +<p>Um objeto {{domxref("DOMRequest")}} para manipular o sucesso ou erro da chamada.</p> + +<p>Se o método chamado é executado com sucesso, o resultado será um array de objetos {{Anch("mozAlarm")}}.</p> + +<h3 id="mozAlarm">mozAlarm</h3> + +<p>São objetos javascript anônimos com as seguintes propriedades:</p> + +<dl> + <dt><code>id</code></dt> + <dd>um número represetando o id do alarme</dd> + <dt><code>date</code></dt> + <dd>um objeto <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Date" title="/en-US/docs/JavaScript/Reference/Global_Objects/Date">Date</a> representando a hora agendada para o alarme.</dd> + <dt><code>respectTimezone</code></dt> + <dd>String que indica se o alarme irá respeitar ou ignorar o fuso-horário do objeto <code>date</code>. o valor da string pode ser <code>ignoreTimezone</code> ou <code>honorTimezone </code></dd> + <dt><code>data</code></dt> + <dd>um objeto JavaScript contendo uma data que será armazenada com o alarme</dd> +</dl> + +<h2 id="Example">Example</h2> + +<pre class="brush: js">var request = navigator.mozAlarms.getAll(); + +request.onsuccess = function () { + console.log('Sucesso:' + this.result.length + 'alarms pending'); + + this.result.forEach(function (alarm) { + console.log(alarm.id + ' : ' + alarm.date.toString() + ' : ' + alarm.respectTimezone); + }); +} + +request.onerror = function () { + console.log('Erro: ' + this.error); +} +</pre> + +<h2 id="Especificação">Especificação</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Status</th> + <th scope="col">Comentário</th> + </tr> + <tr> + <td>{{ SpecName('Alarm API', '#interface-alarmmanager') }}</td> + <td>{{ Spec2('Alarm API') }}</td> + <td>Define a interface do <code>AlarmManager</code>.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>Suporte básico</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Firefox OS</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Suporte básico</td> + <td>{{CompatNo()}}</td> + <td>1.0</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + <td>{{CompatNo()}}</td> + </tr> + </tbody> +</table> +</div> + +<h3 id="Nota_de_implementação_Gecko">Nota de implementação Gecko</h3> + +<p>Essa API está atualmente em avaliação no Firefox OS, estando disponível apenas para aplicativos instalados. A especifficação atual para essa API não considera estável o seu uso sem o prefixo.</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{domxref("MozAlarmsManager")}}</li> + <li>{{domxref("DOMRequest")}}</li> +</ul> diff --git a/files/pt-br/archive/b2g_os/api/navigator/index.html b/files/pt-br/archive/b2g_os/api/navigator/index.html new file mode 100644 index 0000000000..71b8a5e01c --- /dev/null +++ b/files/pt-br/archive/b2g_os/api/navigator/index.html @@ -0,0 +1,12 @@ +--- +title: Navigator (Firefox OS extensions) +slug: Archive/B2G_OS/API/Navigator +translation_of: Archive/B2G_OS/API/Navigator +--- +<p>(pt-BR translation)</p> + +<p>The <code><strong>Navigator</strong></code> interface represents the state and the identity of the user agent. It allows scripts to query it and to register themselves to carry on some activities. This page represents the list of properties and methods added to <code>Navigator</code> on Firefox OS devices. For the list of properties and methods available to any Web sites, consult {{domxref("Navigator")}}.</p> + +<p>A <code>Navigator</code> object can be retrieved using the read-only {{domxref("Window.navigator")}} property.</p> + +<p>{{subpageswithsummaries}}</p> diff --git a/files/pt-br/archive/b2g_os/api/navigator/mozapps/index.html b/files/pt-br/archive/b2g_os/api/navigator/mozapps/index.html new file mode 100644 index 0000000000..45db324cab --- /dev/null +++ b/files/pt-br/archive/b2g_os/api/navigator/mozapps/index.html @@ -0,0 +1,79 @@ +--- +title: Navigator.mozApps +slug: Archive/B2G_OS/API/Navigator/mozApps +translation_of: Archive/B2G_OS/API/Navigator/mozApps +--- +<p>{{ ApiRef("Firefox OS") }}</p> + +<p>{{ non-standard_header() }}</p> + +<h2 id="Summary" name="Summary">Summary</h2> + +<p>Returns an {{ domxref("Apps") }} object you can use to install, manage, and control <a href="/en-US/docs/Web/Apps">Open Web Apps</a> in the browser.</p> + +<h2 id="Syntax" name="Syntax">Syntax</h2> + +<pre class="eval">var <em>apps</em> = window.navigator.mozApps; +</pre> + +<h2 id="Value" name="Value">Value</h2> + +<p><code>navigator.mozApps</code> is an {{ domxref("Apps") }} object you can use to install, manage, and control <a href="/en-US/docs/Web/Apps">Open Web Apps</a> in the browser.</p> + +<h2 id="Specification" name="Specification">Specification</h2> + +<p>Not part of any specification; implemented in Gecko on the basis of {{ Bug("697383") }}.</p> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Basic support</td> + <td>---</td> + <td>{{ CompatGeckoDesktop("11.0") }}</td> + <td>---</td> + <td>---</td> + <td>---</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Basic support</td> + <td>---</td> + <td>{{ CompatGeckoDesktop("11.0") }}</td> + <td>---</td> + <td>---</td> + <td>---</td> + </tr> + </tbody> +</table> +</div> + +<p> </p> + +<div id="link64_adl_tabid" style="display: none;">48</div> |