cordova-plugin-nowplaying

v1.0.2
Cordova Plugin for setting MPNowPlayingInfoCenter.nowPlayingInfo. Only works with > iOS 7.1. Includes support for downloading MPMediaItemPropertyArtwork asynchronously
ecosystem:cordova cordova cordova-ios media audio nowplaying MPNowPlayingInfoCenter lockscreen

Info

Allows setting the lock screen information such as artist, title, and artwork.

https://developer.apple.com/library/prerelease/ios/documentation/MediaPlayer/Reference/MPNowPlayingInfoCenter_Class/index.html

Install

cordova plugin add cordova-plugin-nowplaying

Requires linking of MediaPlayer.framework

XCode project settings under General -> Linked Framework and Libraries

Use

Use only the keys that you have available and leave the others out of the javascript object, that way only the correct keys will be sent to the MPNowPlayingInfoCenter.nowPlayingInfo It will only overwrite the values that come in by cloning the old dictionary.

NowPlaying.set({
    artwork: "http://www.domain.com/image.png", // Can be http:// https:// or image path relative to NSDocumentDirectory
    albumTitle: "The Album Title",
    trackCount: 10,
    trackNumber: 1,
    artist: "The Artist",
    composer: "The Composer",
    discCount: 1,
    discNumber: 1,
    genre: "The Genre",
    persistentID: 12345,
    playbackDuration: 500,
    title: "The Title",
    elapsedPlaybackTime: 30,
    playbackRate: 1,
    playbackQueueIndex: 1,
    playbackQueueCount: 5,
    chapterNumber: 1,
    chapterCount: 2
});

When using in a browser environment it will simply log the calls to NowPlaying.set to the console.

npm i cordova-plugin-nowplaying

Metadata

  • MIT
  • Whatever
  • Leon Radley
  • released 10/1/2015

Downloads

Maintainers