feat: added ability to enable metering for Player on iOS

Author: NathanWalker

.npmignore

@@ -1,5 +1,7 @@
 demo/
 screens/
+node_modules/
+tsconfig.json
 *.png
 *.log
 *.ts

index.d.ts

@@ -11,9 +11,14 @@ export interface AudioPlayerOptions {
     loop: boolean;
 
     /**
-     * Instead of auto-playing, just init the player instance
+     * Prevent autoplay if desired as player autoplays be default
      */
-    initOnly?: boolean;
+    autoPlay?: boolean;
+
+    /**
+     * Set true to enable audio metering.
+     */
+    metering?: boolean;
 
     /**
      * Callback to execute when playback has completed.
@@ -79,7 +84,11 @@ export interface AudioRecorderOptions {
     infoCallback?: Function;
 }
 export interface TNSPlayerI {
+    readonly ios?: any;
+    readonly android?: any;
+    initFromFile(options: AudioPlayerOptions): Promise<any>;
     playFromFile(options: AudioPlayerOptions): Promise<any>;
+    initFromUrl(options: AudioPlayerOptions): Promise<any>;
     playFromUrl(options: AudioPlayerOptions): Promise<any>;
     play(): Promise<boolean>;
     pause(): Promise<boolean>;
@@ -101,7 +110,11 @@ export declare class TNSPlayer {
     private _completeCallback;
     private _errorCallback;
     private _infoCallback;
+    readonly ios: any;
+    readonly android: any;
+    initFromFile(options: AudioPlayerOptions): Promise<any>;
     playFromFile(options: AudioPlayerOptions): Promise<any>;
+    initFromUrl(options: AudioPlayerOptions): Promise<any>;
     playFromUrl(options: AudioPlayerOptions): Promise<any>;
     pause(): Promise<any>;
     resume(): void;
@@ -111,6 +124,7 @@ export declare class TNSPlayer {
     isAudioPlaying(): boolean;
     getAudioTrackDuration(): Promise<string>;
     audioPlayerDidFinishPlayingSuccessfully(player?: any, flag?: boolean): void;
+    readonly currentTime: number;
     private reset();
 }
 export declare class TNSRecorder {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "nativescript-audio",
-  "version": "3.1.0",
+  "version": "3.1.5",
   "description": "NativeScript plugin to record and play audio.",
   "main": "audio",
   "typings": "index.d.ts",

src/common.ts

@@ -1,6 +1,12 @@
 import {AudioPlayerOptions, AudioRecorderOptions} from './options';
 
 export interface TNSPlayerI {
+  /**
+   * native instance getters
+   */
+  readonly ios?: any;
+  readonly android?: any;
+
   /**
    * Starts playing audio file from local app files.
    */
@@ -40,6 +46,11 @@ export interface TNSPlayerI {
    * Get the duration of the audio file playing.
    */
   getAudioTrackDuration(): Promise<string>;
+
+  /**
+   * current time
+   */
+  readonly currentTime: number;
 }
 
 export interface TNSRecordI {

src/ios/player.ts

@@ -47,6 +47,10 @@ export class TNSPlayer extends NSObject implements TNSPlayerI {
         this._player = AVAudioPlayer.alloc().initWithContentsOfURLError(NSURL.fileURLWithPath(fileName));
         this._player.delegate = this;
 
+        if (options.metering) {
+          this._player.meteringEnabled = true;
+        }
+
         if (options.loop) {
           this._player.numberOfLoops = -1;
         }
@@ -97,6 +101,10 @@ export class TNSPlayer extends NSObject implements TNSPlayerI {
           this._player = (<any>AVAudioPlayer.alloc()).initWithDataError(data, null);
           this._player.delegate = this;
           this._player.numberOfLoops = options.loop ? -1 : 0;
+          
+          if (options.metering) {
+            this._player.meteringEnabled = true;
+          }
 
           if (options.autoPlay) this._player.play();
 

src/options.ts

@@ -23,6 +23,11 @@ export interface AudioPlayerOptions {
    */
   autoPlay?: boolean;
 
+  /**
+   * Enable metering. Off by default.
+   */
+  metering?: boolean;
+
   /**
    * Gets or sets the callback when an error occurs with the audio player.
    * @returns {Object} An object containing the native values for the error callback.