Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(184)

Unified Diff: ppapi/c/dev/ppb_alarms_dev.h

Issue 103993006: Add PPB_Alarms_Dev interface definition. (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: . Created 7 years ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « ppapi/c/dev/pp_optional_structs_dev.h ('k') | ppapi/generators/idl_c_header.py » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: ppapi/c/dev/ppb_alarms_dev.h
diff --git a/ppapi/c/dev/ppb_alarms_dev.h b/ppapi/c/dev/ppb_alarms_dev.h
new file mode 100644
index 0000000000000000000000000000000000000000..efd79f9a3a5a52b4dffb09784f2242e810751739
--- /dev/null
+++ b/ppapi/c/dev/ppb_alarms_dev.h
@@ -0,0 +1,210 @@
+/* Copyright (c) 2013 The Chromium Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ */
+
+/* From dev/ppb_alarms_dev.idl modified Tue Dec 10 17:40:20 2013. */
+
+#ifndef PPAPI_C_DEV_PPB_ALARMS_DEV_H_
+#define PPAPI_C_DEV_PPB_ALARMS_DEV_H_
+
+#include "ppapi/c/dev/pp_optional_structs_dev.h"
+#include "ppapi/c/pp_array_output.h"
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_completion_callback.h"
+#include "ppapi/c/pp_instance.h"
+#include "ppapi/c/pp_macros.h"
+#include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/pp_var.h"
+
+#define PPB_ALARMS_DEV_INTERFACE_0_1 "PPB_Alarms(Dev);0.1"
+#define PPB_ALARMS_DEV_INTERFACE PPB_ALARMS_DEV_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the Pepper equivalent of the <code>chrome.alarms</code>
+ * extension API.
+ */
+
+
+/**
+ * @addtogroup Structs
+ * @{
+ */
+struct PP_Alarms_Alarm_Dev {
+ /**
+ * Name of this alarm.
+ */
+ struct PP_Var name;
+ /**
+ * Time at which this alarm was scheduled to fire, in milliseconds past the
+ * epoch. For performance reasons, the alarm may have been delayed an
+ * arbitrary amount beyond this.
+ */
+ double scheduled_time;
+ /**
+ * If set, the alarm is a repeating alarm and will fire again in
+ * <code>period_in_minutes</code> minutes.
+ */
+ struct PP_Optional_Double_Dev period_in_minutes;
+};
+
+struct PP_Alarms_AlarmCreateInfo_Dev {
+ /**
+ * Time at which the alarm should fire, in milliseconds past the epoch.
+ */
+ struct PP_Optional_Double_Dev when;
+ /**
+ * Length of time in minutes after which the
+ * <code>PP_Alarms_OnAlarm_Dev</code> event should fire.
+ */
+ struct PP_Optional_Double_Dev delay_in_minutes;
+ /**
+ * If set, the <code>PP_Alarms_OnAlarm_Dev</code> event should fire every
+ * <code>period_in_minutes</code> minutes after the initial event specified by
+ * <code>when</code> or <code>delay_in_minutes</code>. If not set, the alarm
+ * will only fire once.
+ */
+ struct PP_Optional_Double_Dev period_in_minutes;
+};
+
+struct PP_Alarms_Alarm_Array_Dev {
+ uint32_t size;
+ struct PP_Alarms_Alarm_Dev *elements;
+};
+/**
+ * @}
+ */
+
+/**
+ * @addtogroup Typedefs
+ * @{
+ */
+/**
+ * Fired when an alarm has elapsed. Useful for event pages.
+ *
+ * @param[in] listener_id The listener ID.
+ * @param[inout] user_data The opaque pointer that was used when registering the
+ * listener.
+ * @param[in] alarm The alarm that has elapsed.
+ */
+typedef void (*PP_Alarms_OnAlarm_Dev)(
+ uint32_t listener_id,
+ void* user_data,
+ const struct PP_Alarms_Alarm_Dev* alarm);
+/**
+ * @}
+ */
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+struct PPB_Alarms_Dev_0_1 {
+ /**
+ * Creates an alarm. Near the time(s) specified by <code>alarm_info</code>,
+ * the <code>PP_Alarms_OnAlarm_Dev</code> event is fired. If there is another
+ * alarm with the same name (or no name if none is specified), it will be
+ * cancelled and replaced by this alarm.
+ *
+ * In order to reduce the load on the user's machine, Chrome limits alarms
+ * to at most once every 1 minute but may delay them an arbitrary amount more.
+ * That is, setting
+ * <code>PP_Alarms_AlarmCreateInfo_Dev.delay_in_minutes</code> or
+ * <code>PP_Alarms_AlarmCreateInfo_Dev.period_in_minutes</code> to less than
+ * <code>1</code> will not be honored and will cause a warning.
+ * <code>PP_Alarms_AlarmCreateInfo_Dev.when</code> can be set to less than 1
+ * minute after "now" without warning but won't actually cause the alarm to
+ * fire for at least 1 minute.
+ *
+ * To help you debug your app or extension, when you've loaded it unpacked,
+ * there's no limit to how often the alarm can fire.
+ *
+ * @param[in] instance A <code>PP_Instance</code>.
+ * @param[in] name A string or undefined <code>PP_Var</code>. Optional name to
+ * identify this alarm. Defaults to the empty string.
+ * @param[in] alarm_info Describes when the alarm should fire. The initial
+ * time must be specified by either <code>when</code> or
+ * <code>delay_in_minutes</code> (but not both). If
+ * <code>period_in_minutes</code> is set, the alarm will repeat every
+ * <code>period_in_minutes</code> minutes after the initial event. If neither
+ * <code>when</code> or <code>delay_in_minutes</code> is set for a repeating
+ * alarm, <code>period_in_minutes</code> is used as the default for
+ * <code>delay_in_minutes</code>.
+ */
+ void (*Create)(PP_Instance instance,
+ struct PP_Var name,
+ const struct PP_Alarms_AlarmCreateInfo_Dev* alarm_info);
+ /**
+ * Retrieves details about the specified alarm.
+ *
+ * @param[in] instance A <code>PP_Instance</code>.
+ * @param[in] name A string or undefined <code>PP_Var</code>. The name of the
+ * alarm to get. Defaults to the empty string.
+ * @param[out] alarm A <code>PP_Alarms_Alarm_Dev</code> struct to store the
+ * output result.
+ * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
+ * completion.
+ *
+ * @return An error code from <code>pp_errors.h</code>
+ */
+ int32_t (*Get)(PP_Instance instance,
+ struct PP_Var name,
+ struct PP_Alarms_Alarm_Dev* alarm,
+ struct PP_CompletionCallback callback);
+ /**
+ * Gets an array of all the alarms.
+ *
+ * @param[in] instance A <code>PP_Instance</code>.
+ * @param[out] alarms A <code>PP_Alarms_Alarm_Array_Dev</code> to store the
+ * output result.
+ * @param[in] array_allocator A <code>PP_ArrayOutput</code> to allocate memory
+ * for <code>alarms</code>.
+ * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
+ * completion.
+ *
+ * @return An error code from <code>pp_errors.h</code>
+ */
+ int32_t (*GetAll)(PP_Instance instance,
+ struct PP_Alarms_Alarm_Array_Dev* alarms,
+ struct PP_ArrayOutput array_allocator,
+ struct PP_CompletionCallback callback);
+ /**
+ * Clears the alarm with the given name.
+ *
+ * @param[in] instance A <code>PP_Instance</code>.
+ * @param[in] name A string or undefined <code>PP_Var</code>. The name of the
+ * alarm to clear. Defaults to the empty string.
+ */
+ void (*Clear)(PP_Instance instance, struct PP_Var name);
+ /**
+ * Clears all alarms.
+ *
+ * @param[in] instance A <code>PP_Instance</code>.
+ */
+ void (*ClearAll)(PP_Instance instance);
+ /**
+ * Registers <code>PP_Alarms_OnAlarm_Dev</code> event.
+ *
+ * @param[in] instance A <code>PP_Instance</code>.
+ * @param[in] callback The callback to receive notifications.
+ * @param[inout] user_data An opaque pointer that will be passed to
+ * <code>callback</code>.
+ *
+ * @return A listener ID, or 0 if failed.
+ *
+ * TODO(yzshen): add a PPB_Events_Dev interface for unregistering:
+ * void UnregisterListener(PP_instance instance, uint32_t listener_id);
+ */
+ uint32_t (*AddOnAlarmListener)(PP_Instance instance,
+ PP_Alarms_OnAlarm_Dev callback,
+ void* user_data);
+};
+
+typedef struct PPB_Alarms_Dev_0_1 PPB_Alarms_Dev;
+/**
+ * @}
+ */
+
+#endif /* PPAPI_C_DEV_PPB_ALARMS_DEV_H_ */
+
« no previous file with comments | « ppapi/c/dev/pp_optional_structs_dev.h ('k') | ppapi/generators/idl_c_header.py » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698