new cordova plugins

cordova/plugins/de.appplant.cordova.plugin.background-mode/src/ios/APPBackgroundMode.h

@@ -0,0 +1,37 @@
+/*
+    Copyright 2013-2014 appPlant UG
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+*/
+
+#import <Foundation/Foundation.h>
+#import <AVFoundation/AVFoundation.h>
+#import <AudioToolbox/AudioToolbox.h>
+#import <Cordova/CDVPlugin.h>
+
+@interface APPBackgroundMode : CDVPlugin  {
+    AVAudioPlayer *audioPlayer;
+    BOOL enabled;
+}
+
+// Activate the background mode
+- (void) enable:(CDVInvokedUrlCommand *)command;
+// Deactivate the background mode
+- (void) disable:(CDVInvokedUrlCommand *)command;
+
+@end

cordova/plugins/de.appplant.cordova.plugin.background-mode/src/ios/APPBackgroundMode.m

@@ -0,0 +1,191 @@
+/*
+    Copyright 2013-2014 appPlant UG
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+*/
+
+#import "APPBackgroundMode.h"
+
+@implementation APPBackgroundMode
+
+NSString *const kAPPBackgroundJsNamespace = @"cordova.plugins.backgroundMode";
+NSString *const kAPPBackgroundEventActivate = @"activate";
+NSString *const kAPPBackgroundEventDeactivate = @"deactivate";
+NSString *const kAPPBackgroundEventFailure = @"failure";
+
+#pragma mark -
+#pragma mark Initialization methods
+
+/**
+ * Initialize the plugin.
+ */
+- (void) pluginInitialize
+{
+    [self disable:NULL];
+    [self configureAudioPlayer];
+    [self configureAudioSession];
+    [self observeLifeCycle];
+}
+
+/**
+ * Register the listener for pause and resume events.
+ */
+- (void) observeLifeCycle
+{
+    NSNotificationCenter* listener = [NSNotificationCenter defaultCenter];
+
+    if (&UIApplicationDidEnterBackgroundNotification && &UIApplicationWillEnterForegroundNotification) {
+
+        [listener addObserver:self
+                     selector:@selector(keepAwake)
+                         name:UIApplicationDidEnterBackgroundNotification
+                       object:nil];
+
+        [listener addObserver:self
+                     selector:@selector(stopKeepingAwake)
+                         name:UIApplicationWillEnterForegroundNotification
+                       object:nil];
+
+        [listener addObserver:self
+                     selector:@selector(handleAudioSessionInterruption:)
+                         name:AVAudioSessionInterruptionNotification
+                       object:nil];
+
+    } else {
+        [self enable:NULL];
+        [self keepAwake];
+    }
+}
+
+#pragma mark -
+#pragma mark Interface methods
+
+/**
+ * Enable the mode to stay awake
+ * when switching to background for the next time.
+ */
+- (void) enable:(CDVInvokedUrlCommand *)command
+{
+    enabled = YES;
+}
+
+/**
+ * Disable the background mode
+ * and stop being active in background.
+ */
+- (void) disable:(CDVInvokedUrlCommand *)command
+{
+    enabled = NO;
+
+    [self stopKeepingAwake];
+}
+
+#pragma mark -
+#pragma mark Core methods
+
+/**
+ * Keep the app awake.
+ */
+- (void) keepAwake {
+    if (enabled) {
+        [audioPlayer play];
+        [self fireEvent:kAPPBackgroundEventActivate withParams:NULL];
+    }
+}
+
+/**
+ * Let the app going to sleep.
+ */
+- (void) stopKeepingAwake {
+
+    if (TARGET_IPHONE_SIMULATOR) {
+        NSLog(@"BackgroundMode: On simulator apps never pause in background!");
+    }
+
+    if (audioPlayer.isPlaying) {
+        [self fireEvent:kAPPBackgroundEventDeactivate withParams:NULL];
+    }
+
+    [audioPlayer pause];
+}
+
+/**
+ * Configure the audio player.
+ */
+- (void) configureAudioPlayer {
+    NSString* path = [[NSBundle mainBundle] pathForResource:@"appbeep"
+                                                     ofType:@"wav"];
+
+    NSURL* url = [NSURL fileURLWithPath:path];
+
+
+    audioPlayer = [[AVAudioPlayer alloc] initWithContentsOfURL:url
+                                                         error:NULL];
+
+    // Silent
+    audioPlayer.volume = 0;
+    // Infinite
+    audioPlayer.numberOfLoops = -1;
+};
+
+/**
+ * Configure the audio session.
+ */
+- (void) configureAudioSession {
+    AVAudioSession* session = [AVAudioSession
+                               sharedInstance];
+
+    // Play music even in background and dont stop playing music
+    // even another app starts playing sound
+    [session setCategory:AVAudioSessionCategoryPlayback
+             withOptions:AVAudioSessionCategoryOptionMixWithOthers
+                   error:NULL];
+
+    [session setActive:YES error:NULL];
+};
+
+#pragma mark -
+#pragma mark Helper methods
+
+/**
+ * Restart playing sound when interrupted by phone calls.
+ */
+- (void) handleAudioSessionInterruption:(NSNotification*)notification {
+    [self fireEvent:kAPPBackgroundEventDeactivate withParams:NULL];
+    [self keepAwake];
+}
+
+/**
+ * Method to fire an event with some parameters in the browser.
+ */
+- (void) fireEvent:(NSString*)event withParams:(NSString*)params
+{
+    NSString* active = [event isEqualToString:kAPPBackgroundEventActivate] ? @"true" : @"false";
+
+    NSString* flag = [NSString stringWithFormat:@"%@._isActive=%@;",
+                    kAPPBackgroundJsNamespace, active];
+
+    NSString* fn = [NSString stringWithFormat:@"setTimeout('%@.on%@(%@)',0);",
+                    kAPPBackgroundJsNamespace, event, params];
+
+    NSString* js = [flag stringByAppendingString:fn];
+
+    [self.commandDelegate evalJs:js];
+}
+
+@end