npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

nativescript-will

v5.0.8

Published

NativeScript plugin to play audio (but not record, removed for this fork)

Downloads

5

Readme


Installation

tns plugin add nativescript-audio


Android Native Classes

iOS Native Classes

Note: You will need to grant permissions on iOS to allow the device to access the microphone if you are using the recording function. If you don't, your app may crash on device and/or your app might be rejected during Apple's review routine. To do this, add this key to your app/App_Resources/iOS/Info.plist file:

<key>NSMicrophoneUsageDescription</key>
<string>Recording Practice Sessions</string>

Usage

TypeScript Example

import { TNSPlayer } from 'nativescript-audio';

export class YourClass {
  private _player: TNSPlayer;

  constructor() {
    this._player = new TNSPlayer();
    this._player.debug = true; // set true to enable TNSPlayer console logs for debugging.
    this._player
      .initFromFile({
        audioFile: '~/audio/song.mp3', // ~ = app directory
        loop: false,
        completeCallback: this._trackComplete.bind(this),
        errorCallback: this._trackError.bind(this)
      })
      .then(() => {
        this._player.getAudioTrackDuration().then(duration => {
          // iOS: duration is in seconds
          // Android: duration is in milliseconds
          console.log(`song duration:`, duration);
        });
      });
  }

  public togglePlay() {
    if (this._player.isAudioPlaying()) {
      this._player.pause();
    } else {
      this._player.play();
    }
  }

  private _trackComplete(args: any) {
    console.log('reference back to player:', args.player);
    // iOS only: flag indicating if completed succesfully
    console.log('whether song play completed successfully:', args.flag);
  }

  private _trackError(args: any) {
    console.log('reference back to player:', args.player);
    console.log('the error:', args.error);
    // Android only: extra detail on error
    console.log('extra info on the error:', args.extra);
  }
}

Javascript Example:

const audio = require('nativescript-audio');

const player = new audio.TNSPlayer();
const playerOptions = {
  audioFile: 'http://some/audio/file.mp3',
  loop: false,
  completeCallback: function() {
    console.log('finished playing');
  },
  errorCallback: function(errorObject) {
    console.log(JSON.stringify(errorObject));
  },
  infoCallback: function(args) {
    console.log(JSON.stringify(args));
  }
};

player
  .playFromUrl(playerOptions)
  .then(function(res) {
    console.log(res);
  })
  .catch(function(err) {
    console.log('something went wrong...', err);
  });

API

Recorder

TNSRecorder Methods

| Method | Description | | ----------------------------------------------------------- | ------------------------------------------------------------------------ | | TNSRecorder.CAN_RECORD(): boolean - static method | Determine if ready to record. | | start(options: AudioRecorderOptions): Promise<void> | Start recording to file. | | stop(): Promise<void> | Stop recording. | | pause(): Promise<void> | Pause recording. | | resume(): Promise<void> | Resume recording. | | dispose(): Promise<void> | Free up system resources when done with recorder. | | getMeters(channel?: number): number | Returns the amplitude of the input. | | isRecording(): boolean - iOS Only | Returns true if recorder is actively recording. | | requestRecordPermission(): Promise<void> | Android Only Resolves the promise is user grants the permission. | | hasRecordPermission(): boolean | Android Only Returns true if RECORD_AUDIO permission has been granted. |

TNSRecorder Instance Properties

| Property | Description | | -------- | ---------------------------------------------------------- | | ios | Get the native AVAudioRecorder class instance. | | android | Get the native MediaRecorder class instance. | | debug | Set true to enable debugging console logs (default false). |

Player

TNSPlayer Methods

| Method | Description | | ---------------------------------------------------------------------- | ------------------------------------------------------------ | | initFromFile(options: AudioPlayerOptions): Promise | Initialize player instance with a file without auto-playing. | | playFromFile(options: AudioPlayerOptions): Promise | Auto-play from a file. | | initFromUrl(options: AudioPlayerOptions): Promise | Initialize player instance from a url without auto-playing. | | playFromUrl(options: AudioPlayerOptions): Promise | Auto-play from a url. | | pause(): Promise<boolean> | Pause playback. | | resume(): void | Resume playback. | | seekTo(time:number): Promise<boolean> | Seek to position of track (in seconds). | | dispose(): Promise<boolean> | Free up resources when done playing audio. | | isAudioPlaying(): boolean | Determine if player is playing. | | getAudioTrackDuration(): Promise<string> | Duration of media file assigned to the player. | | playAtTime(time: number): void - iOS Only | Play audio track at specific time of duration. | | changePlayerSpeed(speed: number): void - On Android Only API 23+ | Change the playback speed of the media player. |

TNSPlayer Instance Properties

| Property | Description | | ----------------------- | ---------------------------------------------------------- | | ios | Get the native ios AVAudioPlayer instance. | | android | Get the native android MediaPlayer instance. | | debug: boolean | Set true to enable debugging console logs (default false). | | currentTime: number | Get the current time in the media file's duration. | | volume: number | Get/Set the player volume. Value range from 0 to 1. |

License

MIT

Demo App

  • fork/clone the repository
  • cd into the src directory
  • execute npm run demo.android or npm run demo.ios (scripts are located in the scripts of the package.json in the src directory if you are curious)