Tutorial 29 - Codea v1.5.2: Objective C Add On, iAds

Figure 0. Codea implementing iAds - showAdFromTop()

29.1 Overview

CodeaAddon is an experimental protocol for adding native extensions to exported Codea projects. You must deal with Lua directly to register your functions and globals. This protocol should be considered alpha and is subject to change in future Codea releases.

With that disclaimer out of the way, let's have a look at what we can do with this new functionality. We have previously done tutorials to add Game Center and iAd functionality using the old runtime but with the great new export to Xcode functionality, this is no longer the best way to skin that particular cat.

You may want to re-read our previous tutorial on implementing iAds in Codea as we won't cover the same background in this tutorial.

We will build on the previous tutorial which uses the audio add on. This has the added benefit of showing how you can stack a number of add ons to the same project.

Note that before you start adding advertising support to your applications available on iTunes, you must first agree to the iAd Network agreement. Further, you must explicitly enable iAd for each application in iTunes Connect. As a part of the iAd Network, you control the kinds of ads that are delivered to your application. We don't need to do this to test it in the simulator though.

Figure 1. Add the iAd Framework to your App

29.2 Add the iAd Framework to your App

Fire up Xcode and load the exported version of your Codea application (See Tutorial 27). Click on the imported project file at the top of the project navigator then in the Build Phases tab, scroll down to the link binary with libraries area and select the drop down arrow. Click on the "+" button below your existing frameworks to add a new framework. Find iAds and click on "Add" (Figure 1).

29.3 Update the AppDelegate Files

In the AppDelegate we need to register our new add on classes. The new AppDelegate.h file now looks like:


//
//  AppDelegate.h
//  AudioDemo
//
//  Used to demonstrate the audio add on and iAds add on libraries
//
//  Created by Reefwing Software on Sunday, 14 April 2013
//  Copyright (c) Reefwing Software. All rights reserved.
//

#import <UIKit/UIKit.h>
#import "AudioAddOn.h"
#import "IAdsAddOn.h"

@class CodeaViewController;

@interface AppDelegate : UIResponder <UIApplicationDelegate>

@property (strong, nonatomic) IAdsAddOn *iAdsAddOn;
@property (strong, nonatomic) AudioAddOn *audioAddOn;
@property (strong, nonatomic) UIWindow *window;
@property (strong, nonatomic) CodeaViewController *viewController;

@end


And similarly to what we had in the previous tutorial AppDelegate.mm now looks like:


//
//  AppDelegate.mm
//  AudioDemo
//
//  Created by Reefwing Software on Sunday, 14 April 2013
//  Copyright (c) Reefwing Software. All rights reserved.
//

#import "AppDelegate.h"
#import "CodeaViewController.h"

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    self.viewController = [[CodeaViewController alloc] init];
    
    //  Create and add our AudioAddOn to Codea
    
    self.audioAddOn = [[AudioAddOn alloc] init];
    [self.viewController registerAddon: self.audioAddOn];
    
    //  Create and add our iAdsAddOn to Codea
    
    self.iAdsAddOn = [[IAdsAddOn alloc] init];
    [self.viewController registerAddon: self.iAdsAddOn];
    
    NSString* projectPath = [[[NSBundle mainBundle] bundlePath] stringByAppendingPathComponent:@"AudioDemo.codea"];
    
    [self.viewController loadProjectAtPath:projectPath];
    
    self.window.rootViewController = self.viewController;
    [self.window makeKeyAndVisible];
    
    return YES;
}

- (void)applicationWillResignActive:(UIApplication *)application
{
}

- (void)applicationDidEnterBackground:(UIApplication *)application
{
}

- (void)applicationWillEnterForeground:(UIApplication *)application
{
}

- (void)applicationDidBecomeActive:(UIApplication *)application
{
}

- (void)applicationWillTerminate:(UIApplication *)application
{
}

@end

29.4 The iAds Add On

Our iAds add on implements two internal booleans, isBannerVisible and showBannerFromTop. Hopefully the use of these should be fairly obvious. We also register three new functions for use within Codea:

1. showAdFromTop();
2. showAdFromBottom(); and
3. hideAd()

Our example project demonstrates the use of all 3 of these functions. We start by displaying Ads from the top of the page (once the ad has been loaded from the ad server). We hide ads when the play button is tapped and then show them from the bottom when the stop button is tapped.

In the simulator apple will send you ad errors regularly (e.g. Ad inventory unavailable) to make sure that your code can handle this. Your app will get rejected if it displays an empty ad banner so the add on takes care of this situation. When displaying the ad banner, it will slide down from the top or up from the bottom depending on which function that you have used. Similarly hideAd() will animate the ad sliding above or below the screen depending on the state of the boolean showBannerFromTop.

Figure 2. Codea implementing iAds - showAdFromBottom()

This example add on only handles ads for an iPad in portrait orientation. We have included device detection macros in IAdsAddOn.h, just remove the comment slashes if you want to use these to position your Ads. To handle different orientations and devices update the banner view frame variables in the two methods:

1. - (void)showBannerViewAnimated:(BOOL)animated; and
2. - (void)hideBannerViewAnimated:(BOOL)animated.

If you don't want the banner views to slide to the new position then set animated = NO for the above two methods.

29.5 Download the Code

The complete code listing is available below.

	//
	// AppDelegate.h
	// AudioDemo
	//
	// Used to demonstrate the audio add on and iAds add on libraries
	//
	// Created by Reefwing Software on Sunday, 14 April 2013
	// Copyright (c) Reefwing Software. All rights reserved.
	//
	#import <UIKit/UIKit.h>
	#import "AudioAddOn.h"
	#import "IAdsAddOn.h"
	@class CodeaViewController;
	@interface AppDelegate : UIResponder <UIApplicationDelegate>
	@property (strong, nonatomic) IAdsAddOn *iAdsAddOn;
	@property (strong, nonatomic) AudioAddOn *audioAddOn;
	@property (strong, nonatomic) UIWindow *window;
	@property (strong, nonatomic) CodeaViewController *viewController;
	@end

view raw AppDelegate.h hosted with ❤ by GitHub

	//
	// AppDelegate.mm
	// AudioDemo
	//
	// Created by Reefwing Software on Sunday, 14 April 2013
	// Copyright (c) Reefwing Software. All rights reserved.
	//
	#import "AppDelegate.h"
	#import "CodeaViewController.h"
	@implementation AppDelegate
	- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
	{
	self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
	self.viewController = [[CodeaViewController alloc] init];
	// Create and add our AudioAddOn to Codea
	self.audioAddOn = [[AudioAddOn alloc] init];
	[self.viewController registerAddon: self.audioAddOn];
	// Create and add our iAdsAddOn to Codea
	self.iAdsAddOn = [[IAdsAddOn alloc] init];
	[self.viewController registerAddon: self.iAdsAddOn];
	NSString* projectPath = [[[NSBundle mainBundle] bundlePath] stringByAppendingPathComponent:@"AudioDemo.codea"];
	[self.viewController loadProjectAtPath:projectPath];
	self.window.rootViewController = self.viewController;
	[self.window makeKeyAndVisible];
	return YES;
	}
	- (void)applicationWillResignActive:(UIApplication *)application
	{
	}
	- (void)applicationDidEnterBackground:(UIApplication *)application
	{
	}
	- (void)applicationWillEnterForeground:(UIApplication *)application
	{
	}
	- (void)applicationDidBecomeActive:(UIApplication *)application
	{
	}
	- (void)applicationWillTerminate:(UIApplication *)application
	{
	}
	@end

view raw AppDelegate.mm hosted with ❤ by GitHub

	//
	// AudioAddOn.h
	// AudioDemo
	//
	// Created by David Such on 13/04/13.
	// Copyright (c) 2013 Reefwing Software. All rights reserved.
	//
	// Version: 1.0 - Original (13/04/13)
	// 1.1 - Volume control & monitoring added, metering enabled (14/04/13)
	// 1.2 - Minor refactoring (19/04/13)
	#import <Foundation/Foundation.h>
	#import <AVFoundation/AVFoundation.h>
	#import "CodeaAddon.h"
	id audioAddOnInstance;
	// This class conforms to the CodeaAddon & AVAudioPlayerDelegate Protocols
	@interface AudioAddOn : NSObject<CodeaAddon, AVAudioPlayerDelegate>
	@property (strong, nonatomic) AVAudioPlayer *player;
	// Forward declare our Lua Audio functions. These are static to confine their scope
	// to this file. By default c functions are global.
	static int playMusic(struct lua_State *state);
	static int stopMusic(struct lua_State *state);
	static int getVolume(struct lua_State *state);
	static int setVolume(struct lua_State *state);
	static int peakPowerForChannel(struct lua_State *state);
	static int averagePowerForChannel(struct lua_State *state);
	@end

view raw AudioAddOn.h hosted with ❤ by GitHub

	//
	// AudioAddOn.m
	// AudioDemo
	//
	// Created by David Such on 13/04/13.
	// Copyright (c) 2013 Reefwing Software. All rights reserved.
	//
	// Version: 1.0 - Original (13/04/13)
	// 1.1 - Volume control & monitoring added, metering enabled (14/04/13)
	// 1.2 - Minor refactoring (19/04/13)
	#import "AudioAddOn.h"
	#import "lua.h"
	@implementation AudioAddOn
	#pragma mark - Initialisation
	- (id)init
	{
	self = [super init];
	if (self)
	{
	// Initialise the Audio Player with your mp3 file.
	NSURL *url = [NSURL fileURLWithPath:[[NSBundle mainBundle]
	pathForResource:@"LunarLander"
	ofType:@"mp3"]];
	NSError *error;
	_player = [[AVAudioPlayer alloc] initWithContentsOfURL: url error: &error];
	if (error)
	NSLog(@"Error initialiasing Audio Add On: %@", [error localizedDescription]);
	else
	{
	// Player initialised, assign delegate to this class
	[_player setDelegate: self];
	// Calling prepareToPlay preloads buffers and acquires the audio hardware needed for playback,
	// which minimizes the lag between calling the play method and the start of sound output.
	[_player prepareToPlay];
	// A value of 0, which is the default, means to play the sound once. Set a positive integer
	// value to specify the number of times to return to the start and play again. For example,
	// specifying a value of 1 results in a total of two plays of the sound. Set any negative
	// integer value to loop the sound indefinitely until you call the stop method.
	[_player setNumberOfLoops: -1];
	// The default value for the meteringEnabled property is off (Boolean NO). Before using metering
	// for an audio player, you need to enable it by setting this property to YES.
	[_player setMeteringEnabled: YES];
	// audioAddOnInstance allows us to access self from within the c functions.
	audioAddOnInstance = self;
	}
	}
	return self;
	}
	#pragma mark - CodeaAddon Delegate
	// Classes which comply with the <CodeaAddon> Protocol must implement this method
	- (void) codea:(CodeaViewController*)controller didCreateLuaState:(struct lua_State*)L
	{
	NSLog(@"AudioAddon Registering Functions");
	// Register the Audio functions, defined below
	lua_register(L, "playMusic", playMusic);
	lua_register(L, "stopMusic", stopMusic);
	lua_register(L, "setVolume", setVolume);
	lua_register(L, "getVolume", getVolume);
	lua_register(L, "peakPowerForChannel", peakPowerForChannel);
	lua_register(L, "averagePowerForChannel", averagePowerForChannel);
	}
	#pragma mark - Audio Add On Functions and associated Methods
	// Objective C Methods
	- (void)startPlayer
	{
	[self.player play];
	}
	- (void)stopPlayer
	{
	if ([self.player isPlaying])
	[self.player stop];
	}
	- (void)setPlayerVolume: (int)setting
	{
	// The volume property is the playback gain for the AV audio player object,
	// it expects a float ranging from 0.0 through 1.0.
	//
	// Our Codea slider control returns an integer from 0 to 100 so we need to
	// convert this to a float in the appropriate range before applying it to
	// our player. As a defensive measure we will clamp the result between 0.0 and 1.0.
	float floatSetting = MAX(0.0f, MIN((float)setting / 100.0f, 1.0f));
	[self.player setVolume: floatSetting];
	}
	- (int)getPlayerVolume
	{
	return (self.player.volume * 100.0f);
	}
	- (int)getPeakPower: (NSUInteger)channel
	{
	if ([self.player isPlaying])
	{
	// Refresh the average and peak power values for all channels of our audio player.
	[self.player updateMeters];
	// Peak power is a floating-point representation, in decibels, of a given audio channel’s current peak power.
	// A return value of 0 dB indicates full scale, or maximum power while a return value of -160 dB indicates
	// minimum power (that is, near silence).
	//
	// If the signal provided to the audio player exceeds ±full scale, then the return value may exceed 0
	// (that is, it may enter the positive range).
	//
	// Channel numbers are zero-indexed. A monaural signal, or the left channel of a stereo signal, has channel number 0.
	float power = -160.0f; // Initialise to silence
	if (channel <= [self.player numberOfChannels])
	power = [self.player peakPowerForChannel: channel];
	// Our dial is expecting a value between 0 and 100.
	if (power >= 0)
	return 100;
	else
	{
	power += 160.0f; // power is now a +ve float between 0 and 160
	power = (power / 160.0f) * 100.0f; // change to a percentage
	return (int)power;
	}
	}
	else
	return 0;
	}
	- (int)getAveragePower: (NSUInteger)channel
	{
	if ([self.player isPlaying])
	{
	// Refresh the average and peak power values for all channels of our audio player.
	[self.player updateMeters];
	// A floating-point representation, in decibels, of a given audio channel’s current average power.
	// A return value of 0 dB indicates full scale, or maximum power; a return value of -160 dB indicates
	// minimum power (that is, near silence).
	//
	// If the signal provided to the audio player exceeds ±full scale, then the return value may exceed 0
	// (that is, it may enter the positive range).
	//
	// Channel numbers are zero-indexed. A monaural signal, or the left channel of a stereo signal, has channel number 0.
	float power = -160.0f; // Initialise to silence
	if (channel <= [self.player numberOfChannels])
	power = [self.player averagePowerForChannel: channel];
	// Our dial is expecting a value between 0 and 100.
	if (power >= 0)
	return 100;
	else
	{
	power += 160.0f; // power is now a +ve float between 0 and 160
	power = (power / 160.0f) * 100.0f; // change to a percentage
	return (int)power;
	}
	}
	else
	return 0;
	}
	// C Functions
	//
	// Note that the returned value from all exported Lua functions is how many values that function should return in Lua.
	// For example, if you return 0 from that function, you are telling Lua that peakPowerForPlayer (for example) returns 0 values.
	// If you return 2, you are telling Lua to expect 2 values on the stack when the function returns.
	//
	// To actually return values, you need to push them onto the Lua stack and then return the number of values you pushed on.
	static int playMusic(struct lua_State *state)
	{
	[audioAddOnInstance startPlayer];
	return 0;
	}
	static int stopMusic(struct lua_State *state)
	{
	[audioAddOnInstance stopPlayer];
	return 0;
	}
	static int getVolume(struct lua_State *state)
	{
	// Push the integer volume onto the Lua stack
	lua_pushinteger(state, [audioAddOnInstance getPlayerVolume]);
	// Our function returns 1 value = volume
	return 1;
	}
	static int setVolume(struct lua_State *state)
	{
	[audioAddOnInstance setPlayerVolume: lua_tonumber(state, 1)];
	return 0;
	}
	static int peakPowerForChannel(struct lua_State *state)
	{
	// Channel numbers are zero-indexed. A monaural signal,
	// or the left channel of a stereo signal, has channel number 0.
	NSUInteger channel = lua_tonumber(state, 1);
	// Push the integer power onto the Lua stack
	lua_pushinteger(state, [audioAddOnInstance getPeakPower: channel]);
	// Our function returns 1 value = peak power
	return 1;
	}
	static int averagePowerForChannel(struct lua_State *state)
	{
	// Channel numbers are zero-indexed. A monaural signal,
	// or the left channel of a stereo signal, has channel number 0.
	NSUInteger channel = lua_tonumber(state, 1);
	// Push the integer power onto the Lua stack
	lua_pushinteger(state, [audioAddOnInstance getAveragePower: channel]);
	// Our function returns 1 value = peak power
	return 1;
	}
	#pragma mark - AVAudioPlayer Delegate
	// These Audio Player call back methods are not used in this tutorial but provided here
	// for information. There are a number of other delegate methods available. Check the
	// documentation.
	- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag
	{
	}
	- (void)audioPlayerDecodeErrorDidOccur:(AVAudioPlayer *)player error:(NSError *)error
	{
	NSLog(@"Error decoding audio file: %@", [error localizedDescription]);
	}
	-(void)audioPlayerBeginInterruption:(AVAudioPlayer *)player
	{
	}
	-(void)audioPlayerEndInterruption:(AVAudioPlayer *)player
	{
	}
	@end

view raw AudioAddOn.m hosted with ❤ by GitHub

	//
	// IAdsAddOn.h
	// AudioDemo
	//
	// Created by David Such on 19/04/13.
	// Copyright (c) 2013 Reefwing Software. All rights reserved.
	//
	// Version: 1.0 - Original (19/04/13)
	#import "CodeaAddon.h"
	#import <iAd/iAd.h>
	#import <Foundation/Foundation.h>
	// Device Detection Macros - can be used to position the banner advertisement based on device.
	// Not used in this tutorial.
	//#define IS_IPAD (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad)
	//#define IS_IPHONE (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPhone)
	//#define IS_IPHONE_5 (IS_IPHONE && [[UIScreen mainScreen] bounds].size.height == 568.0f)
	//#define IS_IPHONE_4 (IS_IPHONE && [[UIScreen mainScreen] bounds].size.height == 480.0f)
	// Create a variable which points to the instance of this class so that we can access self
	// from within the Lua c functions.
	id iAdsAddOnInstance;
	// This class conforms to the CodeaAddon & ADBannerViewDelegate Protocols
	@interface IAdsAddOn : NSObject<CodeaAddon, ADBannerViewDelegate>
	@property BOOL isBannerVisible;
	@property BOOL showBannerFromTop;
	@property (strong, nonatomic) ADBannerView *bannerView;
	@property (weak, nonatomic) CodeaViewController *currentController;
	// Forward declare our Lua iAd functions. These are static to confine their scope
	// to this file. By default c functions are global.
	static int showAdFromTop(struct lua_State *state);
	static int showAdFromBottom(struct lua_State *state);
	static int hideAd(struct lua_State *state);
	@end

view raw IAdsAddOn.h hosted with ❤ by GitHub

	//
	// IAdsAddOn.m
	// AudioDemo
	//
	// Created by David Such on 19/04/13.
	// Copyright (c) 2013 Reefwing Software. All rights reserved.
	//
	// Version: 1.0 - Original (19/04/13)
	#import "lua.h"
	#import "IAdsAddOn.h"
	@implementation IAdsAddOn
	#pragma mark - Initialisation
	- (id)init
	{
	self = [super init];
	if (self)
	{
	// audioAddOnInstance allows us to access self from within the c functions.
	iAdsAddOnInstance = self;
	// Initialise our Instance Variables
	_isBannerVisible = NO;
	_showBannerFromTop = YES;
	// Initialise our iAd Banner View
	CGRect frame = CGRectZero;
	frame.size = [ADBannerView sizeFromBannerContentSizeIdentifier: ADBannerContentSizeIdentifierPortrait];
	_bannerView = [[ADBannerView alloc] initWithFrame: frame];
	_bannerView.requiredContentSizeIdentifiers = [NSSet setWithObject: ADBannerContentSizeIdentifierPortrait];
	_bannerView.delegate = self;
	}
	return self;
	}
	#pragma mark - CodeaAddon Delegate
	// Classes which comply with the <CodeaAddon> Protocol must implement this method
	- (void) codea:(CodeaViewController*)controller didCreateLuaState:(struct lua_State*)L
	{
	NSLog(@"iAdAddOn Registering Functions");
	// Register the iAd functions, defined below
	lua_register(L, "showAdFromTop", showAdFromTop);
	lua_register(L, "showAdFromBottom", showAdFromBottom);
	lua_register(L, "hideAd", hideAd);
	// Hook up with the CodeaViewController - don't try to add subviews in this method.
	self.currentController = controller;
	}
	#pragma mark - iAds Add On Functions and associated Methods
	// Objective C Methods
	- (void)showBannerViewAnimated:(BOOL)animated
	{
	if ([self.bannerView isBannerLoaded])
	{
	// We only display the banner View if it has ads loaded and isn't already visible.
	// Set the banner view starting position as off screen.
	CGRect frame = _bannerView.frame;
	if (_showBannerFromTop)
	frame.origin.y = 0.0f - _bannerView.frame.size.height;
	else
	frame.origin.y = CGRectGetMaxY(self.currentController.view.bounds);
	_bannerView.frame = frame;
	// Set banner View final position to animate to.
	if (_showBannerFromTop)
	frame.origin.y = 0;
	else
	frame.origin.y -= frame.size.height;
	if (animated)
	[UIView animateWithDuration: 0.5 animations: ^{self.bannerView.frame = frame;}];
	else
	self.bannerView.frame = frame;
	_isBannerVisible = YES;
	}
	else
	NSLog(@"showBannerViewAnimated: Unable to display banner, no Ads loaded.");
	}
	- (void)hideBannerViewAnimated:(BOOL)animated
	{
	if (_isBannerVisible)
	{
	CGRect frame = self.bannerView.frame;
	if (_showBannerFromTop)
	frame.origin.y -= frame.size.height;
	else
	frame.origin.y = CGRectGetMaxY(self.currentController.view.bounds);
	if (animated)
	[UIView animateWithDuration: 0.5 animations: ^{self.bannerView.frame = frame;}];
	else
	self.bannerView.frame = frame;
	_isBannerVisible = NO;
	}
	}
	// C Functions
	//
	// Note that the returned value from all exported Lua functions is how many values that function should return in Lua.
	// For example, if you return 0 from that function, you are telling Lua that function returns 0 values.
	// If you return 2, you are telling Lua to expect 2 values on the stack when the function returns.
	//
	// To actually return values, you need to push them onto the Lua stack and then return the number of values you pushed on.
	static int showAdFromTop(struct lua_State *state)
	{
	[iAdsAddOnInstance setShowBannerFromTop: YES];
	[iAdsAddOnInstance showBannerViewAnimated: YES];
	return 0;
	}
	static int showAdFromBottom(struct lua_State *state)
	{
	[iAdsAddOnInstance setShowBannerFromTop: NO];
	[iAdsAddOnInstance showBannerViewAnimated: YES];
	return 0;
	}
	static int hideAd(struct lua_State *state)
	{
	[iAdsAddOnInstance hideBannerViewAnimated: YES];
	return 0;
	}
	#pragma mark - iAd Banner View Delegate
	// Your application implements this method to be notified when a new advertisement is ready for display.
	- (void)bannerViewDidLoadAd:(ADBannerView *)banner
	{
	NSLog(@"Banner View loaded Ads for display.");
	NSLog(@"Active View Controller: %@", self.currentController.class);
	// Add our banner view to the CodeaViewController view, if we haven't already.
	if (![self.currentController.view.subviews containsObject: _bannerView])
	[self.currentController.view addSubview: _bannerView];
	[self showBannerViewAnimated: YES];
	}
	// This method is triggered when an advertisement could not be loaded from the iAds system
	// (perhaps due to a network connectivity issue).
	- (void)bannerView:(ADBannerView *)banner didFailToReceiveAdWithError:(NSError *)error
	{
	NSLog(@"bannerview failed to receive iAd error: %@", [error localizedDescription]);
	[self hideBannerViewAnimated: YES];
	}
	// This method is triggered when the banner confirms that an advertisement is available but before the ad is
	// downloaded to the device and is ready for presentation to the user.
	- (void)bannerViewWillLoadAd:(ADBannerView *)banner
	{
	}
	// This method is triggered when the user touches the iAds banner in your application. If the willLeave argument
	// passed through to the method is YES then your application will be placed into the background while the user is
	// taken elsewhere to interact with or view the ad. If the argument is NO then the ad will be superimposed over your
	// running application.
	- (BOOL)bannerViewActionShouldBegin:(ADBannerView *)banner willLeaveApplication:(BOOL)willLeave
	{
	self.currentController.paused = YES;
	NSLog(@"Ad being displayed - Codea paused.");
	return YES;
	}
	// This method is called when the ad view removes the ad content currently obscuring the application interface.
	// If the application was paused during the ad view session this method can be used to resume activity.
	- (void)bannerViewActionDidFinish:(ADBannerView *)banner
	{
	self.currentController.paused = NO;
	NSLog(@"Ad dismissed - Codea running.");
	}
	@end

view raw IAdsAddOn.m hosted with ❤ by GitHub

	-- AudioDemo
	-- Main.lua
	-- Uses Cider Controls v1.6 from @Mark and @aciolino
	-- make sure you add this as a Dependency
	function setup()
	displayMode(FULLSCREEN)
	setInstructionLimit(0)
	ctlFrame = Control("Audio Player", 20, HEIGHT - 600, 450, HEIGHT - 20)
	ctlFrame.background = color(181, 141, 203, 255)
	ctlFrame.textAlign = CENTER
	ctlFrame.fontSize = 24
	-- Initialise the Cider Controls
	playBtn = TextButton("Play", 70, 480, 225, 520)
	stopBtn = TextButton("Stop", 245, 480, 400, 520)
	sldVolume = Slider("Volume Control", 70, HEIGHT - 450, 400, HEIGHT - 420, 0, 100, 50)
	-- Initialise the Cider Volume Indicators
	dial = Dial("Left", 70, 780, 220, 930, 0, 100, 0)
	doughnut = Doughnut("Right", 250, 780, 400, 930, 0, 100, sldVolume.val)
	doughnut.intervals = 25
	doughnut.warm = 9
	doughnut.hot = 13
	-- Show Banner Ad using iAdsAddOn
	showAdFromTop()
	end
	function draw()
	-- This sets a dark background color
	background(178, 173, 173, 255)
	-- Draw the Cider Controls
	ctlFrame:draw()
	playBtn:draw()
	stopBtn:draw()
	sldVolume:draw()
	dial:draw()
	doughnut:draw()
	-- Update the dB Meter Dials
	--
	-- The iPad should have 2 channels, left = 0 and right = 1
	dial.val = averagePowerForChannel(0) or 0
	doughnut.val = averagePowerForChannel(1) or 0
	end
	function touched(touch)
	if sldVolume: touched(touch) then
	-- call AudioAddOn function
	setVolume(sldVolume.val)
	end
	if playBtn:touched(touch) then
	-- call AudioAddOn and iAdsAddOn function
	playMusic()
	hideAd()
	end
	if stopBtn:touched(touch) then
	-- call AudioAddOn and iAdsAddOn function
	stopMusic()
	showAdFromBottom()
	end
	end

view raw Main.lua hosted with ❤ by GitHub