8/3/2023 0 Comments Opensong music songbook![]() We can use this same API to load multiple songs into the viewer by repeating the song querystring parameter. This is where things get slightly crazy, or as developers would say more "powerful". To go to the second song in the set, we'd use: onsong://open/songs?index=1 Pulling Songs Or go to any song using its numeric index, the first song being at index zero. Or go back to the previous one: onsong://open/songs?index=previous Or where ever we can just go to the next song in the song viewer: onsong://open/songs?index=next Or just as easily go to the last song in the song viewer: onsong://open/songs?index=last To move to the first song, we can use the first value: onsong://open/songs?index=first Of course loading a set is incredibly helpful, but what if we want to navigate through the set? Using the index querystring parameter, we can move through the currently viewed songs whether they are in a collection or set. Onsong://open/songs/?set=current-set Navigation We will start by simply viewing the current set like this: URL actions let you either load an existing set, or create new ones. Sets in OnSong are used to perform songs for a specific gig. Onsong://open/songs/?collection=christmas-songs View Set Onsong://open/songs/?collection=all-songsĪlternately, you can load the contents of a book in the same way: You can load the All Songs collection into the song viewer using the collection querystring parameter like this: Onsong://open/songs/?song=85F0CE06-7414-4FFB-BFF0-14D3507A1AA7 View CollectionĬollections in OnSong include books but also the standard collections like All Songs and Unbound Songs. To open the song Be Still, we'd use this:Īlternately, we could pass a known unique identifier for the song querystring parameter like so: This uses the base action path and the song querystring parameter. OnSong can do this by either searching by song title, or by song identifier. The most simple action is to open a song. You can request to become an affiliate partner with OnSong by emailing us. If that returns false, then the OnSong app is not installed and you can present an appropriate user interface to have the user install OnSong. ![]() Once registered, you can use the method to determine if the URL can be opened. However this does not apply to web-based apps. Without this, your app will not be able to open OnSong scheme. To do this, add onsong as a registered URL scheme. Of course to use any of these API calls, you'll need to ensure the user has OnSong installed on their device. Since the onsong:// URL scheme is used on every version of OnSong, you'll want to ensure you only have the beta version installed to avoid conflict with other versions of the app. You can join our beta team to get pre-release versions of OnSong for testing. The Open Song URL API is only available in OnSong 2020.8 and higher. That makes URL open actions ideal for use if your app is running in portion of the iPad screen. If you are viewing OnSong using a split screen or other multitasking configuration on an iPad, it will remain this way. Since this is a URL scheme, it will result in opening OnSong and bringing it to the foreground if it's not already being viewed. Not only can you use the onsong:// URL scheme to import content into OnSong,īut you can also use it to view specific songs in your library. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |