nativeScript-audio-player | NativeScript 市场place

NativeScript 音频播放器

NativeScript 插件，用于播放 Android 和 iOS 的音频文件。

安装

tns plugin add nativescript-audio-player

原生类

用法

TypeScript 示例

import { TNSPlayer } from 'nativescript-audio-player';

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 示例

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

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

播放器

TNSPlayer 方法

方法	描述
initFromFile(options: AudioPlayerOptions): `Promise`	使用文件初始化播放器实例，不自动播放。
playFromFile(options: AudioPlayerOptions): `Promise`	从文件自动播放。
initFromUrl(options: AudioPlayerOptions): `Promise`	从 URL 初始化播放器实例，不自动播放。
playFromUrl(options: AudioPlayerOptions): `Promise`	从 URL 自动播放。
pause(): `Promise<boolean>`	暂停播放。
resume(): `void`	继续播放。
seekTo(time:number): `Promise<boolean>`	跳转到特定位置。
dispose(): `Promise<boolean>`	播放音频完成后释放资源。
isAudioPlaying(): `boolean`	确定播放器是否正在播放。
getAudioTrackDuration(): `Promise<string>`	分配给播放器的媒体文件持续时间。
playAtTime(time: number): void - *iOS 仅*	在持续时间特定时间播放音频轨道。
changePlayerSpeed(speed: number): void - 仅限 Android API 23+	更改媒体播放器的播放速度。

TNSPlayer 实例属性

属性	描述
ios	获取原生 iOS AVAudioPlayer 实例。
android	获取原生 Android MediaPlayer 实例。
debug: `boolean`	设置为 true 以启用调试控制台日志（默认 false）。
currentTime: `number`	获取媒体文件持续时间中的当前时间。
volume: `number`	获取/设置播放器音量。值范围从 0 到 1。

许可证

MIT