From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../pt-br/archive/b2g_os/api/alarm_api/index.html | 173 +++++++++++++++++++++ files/pt-br/archive/b2g_os/api/index.html | 14 ++ .../archive/b2g_os/api/mozalarmsmanager/index.html | 127 +++++++++++++++ .../mozalarmsmanager.getall/index.html | 140 +++++++++++++++++ .../pt-br/archive/b2g_os/api/navigator/index.html | 12 ++ .../b2g_os/api/navigator/mozapps/index.html | 79 ++++++++++ 6 files changed, 545 insertions(+) create mode 100644 files/pt-br/archive/b2g_os/api/alarm_api/index.html create mode 100644 files/pt-br/archive/b2g_os/api/index.html create mode 100644 files/pt-br/archive/b2g_os/api/mozalarmsmanager/index.html create mode 100644 files/pt-br/archive/b2g_os/api/mozalarmsmanager/mozalarmsmanager.getall/index.html create mode 100644 files/pt-br/archive/b2g_os/api/navigator/index.html create mode 100644 files/pt-br/archive/b2g_os/api/navigator/mozapps/index.html (limited to 'files/pt-br/archive/b2g_os/api') 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 +--- +

{{ SeeCompatTable() }}

+ +

Resumo

+ +

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.

+ +

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.

+ +

Os alarmes são estabelecidos usando o objeto {{domxref("window.navigator.mozAlarms")}} que é uma instância de {{domxref("MozAlarmsManager")}}.

+ +

Programar Alarmes

+ +

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")}}.

+ +
+

Nota: 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.

+
+ +

Alarmes ignorando os fusos-horários

+ +

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).

+ +
// 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);
+};
+
+ +

Alarmes respeitando os fusos-horários

+ +

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).

+ +
// 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);
+};
+
+ +

Gerenciando os alarmes

+ +

Uma vez um alarme é programado, é possível gerenciá-lo.

+ +

O método {{domxref("MozAlarmsManager.getAll")}} retornará a lista completa de alarmes atualmente programados pela aplicação.. Essa lista é um Array de objetos {{Anch("mozAlarm")}}.

+ +

mozAlarm

+ +

{{page("/pt-BR/docs/Web/API/MozAlarmsManager.getAll","mozAlarm")}}

+ +
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);
+};
+
+ +

O método {{domxref("MozAlarmsManager.remove")}} é utilizado para desprogramar um alarme já programado, ou seja, removê-lo.

+ +
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);
+}
+
+ +

Manipulação de alarmes

+ +

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:

+ +

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.

+ +
"messages": [
+  { "alarm": "/index.html" }
+]
+ +

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.

+ +
navigator.mozSetMessageHandler("alarm", function (mozAlarm) {
+  alert("alarm fired: " + JSON.stringify(mozAlarm.data));
+});
+
+ +

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 alarm.

+ +
navigator.mozHasPendingMessage("alarm");
+
+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('Alarm API')}}{{Spec2('Alarm API')}}Especificação inicial.
+ + + +

Supported in Firefox OS 1.0.1.

+ +

Veja mais

+ + 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 +--- +

List of B2G OS APIs

+ +

{{APIListAlpha('/en-US/docs/Archive/B2G_OS/API')}}

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 +--- +

{{APIRef("Firefox OS")}}

+ +

{{ non-standard_header() }}

+ +

{{ B2GOnlyHeader2('installed') }}

+ +

Summary

+ +

The MozAlarmsManager API allows to schedule notifications or applications to be started at a specific time.

+ +

Interface overview

+ +
interface MozAlarmsManager
+{
+  DOMRequest getAll();
+  DOMRequest add(Date date, DOMString respectTimezone, optional object data);
+  void remove(unsigned long id);
+};
+ +

Properties

+ +

None.

+ +

Methods

+ +
+
{{ domxref("MozAlarmsManager.getAll()") }}
+
Gets the list of all alarms currently scheduled.
+
{{ domxref("MozAlarmsManager.add()") }}
+
Allows to schedule a new alarm.
+
{{ domxref("MozAlarmsManager.remove()") }}
+
Allows to remove an existing alarm.
+
+ +

Specification

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{ SpecName('Alarm API', '#interface-alarmmanager') }}{{ Spec2('Alarm API') }}Defines the AlarmManager interface.
+ +

Browser compatibility

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox OSFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo()}}1.0{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}
+
+ +

Gecko implementation note

+ +

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.

+ +

See also

+ + 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 +--- +

{{APIRef("Firefox OS")}}{{ non-standard_header() }}

+ +

{{ B2GOnlyHeader2('installed') }}

+ +

Resumo

+ +

O método getAll é utilizado para retornar uma lista dos alarmes pendentes.

+ +

Sintaxe

+ +
var request = navigator.mozAlarms.getAll();
+ +

Retorno

+ +

Um objeto {{domxref("DOMRequest")}} para manipular o sucesso ou erro da chamada.

+ +

Se o método chamado é executado com sucesso, o resultado será um array de objetos {{Anch("mozAlarm")}}.

+ +

mozAlarm

+ +

São objetos javascript anônimos com as seguintes propriedades:

+ +
+
id
+
um número represetando o id do alarme
+
date
+
um objeto Date representando a hora agendada para o alarme.
+
respectTimezone
+
String que indica se o alarme irá respeitar ou ignorar o fuso-horário do objeto date. o valor da string pode ser ignoreTimezone ou honorTimezone
+
data
+
um objeto JavaScript contendo uma data que será armazenada com o alarme
+
+ +

Example

+ +
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);
+}
+
+ +

Especificação

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{ SpecName('Alarm API', '#interface-alarmmanager') }}{{ Spec2('Alarm API') }}Define a interface do AlarmManager.
+ +

Compatibilidade dos browsers

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Suporte básico{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox OSFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatNo()}}1.0{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}{{CompatNo()}}
+
+ +

Nota de implementação Gecko

+ +

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.

+ +

Veja também

+ + 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 +--- +

(pt-BR translation)

+ +

The Navigator 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 Navigator on Firefox OS devices. For the list of properties and methods available to any Web sites, consult {{domxref("Navigator")}}.

+ +

A Navigator object can be retrieved using the read-only {{domxref("Window.navigator")}} property.

+ +

{{subpageswithsummaries}}

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 +--- +

{{ ApiRef("Firefox OS") }}

+ +

{{ non-standard_header() }}

+ +

Summary

+ +

Returns an {{ domxref("Apps") }} object you can use to install, manage, and control Open Web Apps in the browser.

+ +

Syntax

+ +
var apps = window.navigator.mozApps;
+
+ +

Value

+ +

navigator.mozApps is an {{ domxref("Apps") }} object you can use to install, manage, and control Open Web Apps in the browser.

+ +

Specification

+ +

Not part of any specification; implemented in Gecko on the basis of {{ Bug("697383") }}.

+ +

Browser compatibility

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support---{{ CompatGeckoDesktop("11.0") }}---------
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support---{{ CompatGeckoDesktop("11.0") }}---------
+
+ +

 

+ + -- cgit v1.2.3-54-g00ecf