nstudio / Nativescript Audio
Licence: other
🎤 NativeScript plugin to record and play audio 🎵
Stars: ✭ 139
Programming Languages
typescript
32286 projects
Labels
Projects that are alternatives of or similar to Nativescript Audio
LineMediaPlayer
本地代理服务器监听android mediaplayer播放请求,由本地进行重新封装转发请求,从而达到获取流媒体数据并缓存的功能。
Stars: ✭ 18 (-87.05%)
Mutual labels: mediaplayer
Djmediaplayer
An android Media Player based on vitamio
Stars: ✭ 17 (-87.77%)
Mutual labels: mediaplayer
Guayadeque
Guayadeque is a music management program designed for all music enthusiasts. It is Full Featured Linux media player that can easily manage large collections and uses the Gstreamer media framework.
Stars: ✭ 87 (-37.41%)
Mutual labels: mediaplayer
Dkvideoplayer
Android Video Player. 安卓视频播放器,封装MediaPlayer、ExoPlayer、IjkPlayer。模仿抖音并实现预加载,列表播放,悬浮播放,广告播放,弹幕
Stars: ✭ 3,796 (+2630.94%)
Mutual labels: mediaplayer
Xamarinmediamanager
Cross platform Xamarin plugin to play and control Audio and Video
Stars: ✭ 647 (+365.47%)
Mutual labels: mediaplayer
Mkvideoplayer
MKVideoPlayer library is a video player have some basic features that need to develop an video player application in android studio
Stars: ✭ 54 (-61.15%)
Mutual labels: mediaplayer
android-jungle-mediaplayer
An Android MediaPlayer framework. Can play audio / video, or record audio.
Stars: ✭ 89 (-35.97%)
Mutual labels: mediaplayer
Exoplayerxamarin
Xamarin bindings library for the Google ExoPlayer library
Stars: ✭ 124 (-10.79%)
Mutual labels: mediaplayer
React Native Jw Media Player
React-Native Android/iOS bridge for JWPlayer SDK (https://www.jwplayer.com/)
Stars: ✭ 76 (-45.32%)
Mutual labels: mediaplayer
Exoplayer
An extensible media player for Android
Stars: ✭ 18,648 (+13315.83%)
Mutual labels: mediaplayer
Android Audio Visualizer
🎼 🎹 🎵 Audio visualisation for android MediaPlayer 🔉
Stars: ✭ 468 (+236.69%)
Mutual labels: mediaplayer
Ottliveplayer vlc
An Android OTT Box live mediaplayer app based on vlc git-3.0.0 version
Stars: ✭ 62 (-55.4%)
Mutual labels: mediaplayer
Playerbase
The basic library of Android player will process complex business components. The access is simple。Android播放器基础库,专注于播放视图组件的高复用性和组件间的低耦合,轻松处理复杂业务。
Stars: ✭ 2,814 (+1924.46%)
Mutual labels: mediaplayer
Playerctl
🎧 mpris media player command-line controller for vlc, mpv, RhythmBox, web browsers, cmus, mpd, spotify and others.
Stars: ✭ 1,365 (+882.01%)
Mutual labels: mediaplayer
KingPlayer
🎬 一个专注于 Android 视频播放器的基础库,无缝切换内核。(IjkPlayer、ExoPlayer、VlcPlayer、MediaPlayer)
Stars: ✭ 35 (-74.82%)
Mutual labels: mediaplayer
Universalvideoview
A better Android VideoView with more Media Controller customization. 一个更好用的Android VideoView
Stars: ✭ 941 (+576.98%)
Mutual labels: mediaplayer
Browser Media Keys
Lets you control many web players using the media keys on your keyboard.
Stars: ✭ 125 (-10.07%)
Mutual labels: mediaplayer
Ihequalizerview
An Custom UIView which draws the output of an audio asset in real time.
Stars: ✭ 106 (-23.74%)
Mutual labels: mediaplayer
NativeScript Audio
NativeScript plugin to play and record audio files for Android and iOS.
Installation
NativeScript 7+:
ns plugin add nativescript-audio
NativeScript Version prior to 7:
tns plugin add [email protected]
Android Native Classes
iOS Native Classes
Permissions
iOS
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>
Android
If you are going to use the recorder capability for Android, you need to add the RECORD_AUDIO permission to your AndroidManifest.xml file located in App_Resources.
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
Usage
TypeScript Example
import { TNSPlayer } from 'nativescript-audio';
export class YourClass {
private _player: TNSPlayer;
constructor() {
this._player = new TNSPlayer();
// You can pass a duration hint to control the behavior of other application that may
// be holding audio focus.
// For example: new TNSPlayer(AudioFocusDurationHint.AUDIOFOCUS_GAIN_TRANSIENT);
// Then when you play a song, the previous owner of the
// audio focus will stop. When your song stops
// the previous holder will resume.
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(res => {
console.log(res);
})
.catch(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
Demo App
- fork/clone the repository
- cd into the
src
directory - execute
npm run demo.android
ornpm run demo.ios
(scripts are located in thescripts
of the package.json in thesrc
directory if you are curious)
Note that the project description data, including the texts, logos, images, and/or trademarks,
for each open source project belongs to its rightful owner.
If you wish to add or remove any projects, please contact us at [email protected].