Android - JetPlayer Tutorial

2021-12-07 13:59 Android开发

The Android platform includes a JET engine that lets you add interactive playback of JET audio content in your applications. Android provides JetPlayer class to handle this stuff. In order to Jet Content , you need to use the JetCreator tool that comes with AndroidSDK. The usage of jetCreator has been discussed in the example. In order to play the content created by JetCreator, you need JetPlayer class supported by android. In order to use JetPlayer , you need to instantiate an object of JetPlayer class. Its syntax is given below − <pre class="result notranslate" > JetPlayer jetPlayer = JetPlayer.getJetPlayer(); </pre> The next thing you need to do is to call loadJetFile method and pass in the path of your Jet file. After that you have to add this into the Queue of JetPlayer. Its syntax is given below − <pre class="prettyprint notranslate prettyprinted" > jetPlayer.loadJetFile("/sdcard/level1.jet"); byte segmentId = 0; // queue segment 5, repeat once, use General MIDI, transpose by -1 octave jetPlayer.queueJetSegment(5, -1, 1, -1, 0, segmentId++);</pre> The method queueJetSegment Queues the specified segment in the JET Queue. The last thing you need to is to call the play method to start playing the music. Its syntax is given below − <pre class="result notranslate" > jetPlayer.play(); </pre> Apart from these methods, there are other methods defined in the JetPlayer class. They are defined below − <table class="table table-bordered" > <tbody > <tr > <th >Sr.No</th> <th >Method & description</th> </tr> <tr > <td >1</td> <td >clearQueue() Empties the segment queue, and clears all clips that are scheduled for playback </td> </tr> <tr > <td >2</td> <td >closeJetFile() Closes the resource containing the JET content </td> </tr> <tr > <td >3</td> <td >getJetPlayer() Factory method for the JetPlayer class </td> </tr> <tr > <td >4</td> <td >loadJetFile(String path) Loads a .jet file from a given path </td> </tr> <tr > <td >5</td> <td >pause() Pauses the playback of the JET segment queue </td> </tr> <tr > <td >6</td> <td >release() Stops the current JET playback, and releases all associated native resources </td> </tr> </tbody> </table> <h2 >Example</h2> The following example demonstrates the use of JetCreator tool to create Jet content. Once that content is created, you can play it through JetPlayer. To experiment with this example , you need to run this on an actual device or in an emulator. <table class="table table-bordered" > <tbody > <tr > <th >Steps</th> <th >Description</th> </tr> <tr > <td >1</td> <td >You will use Android studio IDE to create an Android application and name it as JetPlayer under a package com.example.jetplayer. While creating this project, make sure you Target SDK and Compile With at the latest version of Android SDK to use higher levels of APIs.</td> </tr> <tr > <td >2</td> <td >Install Python and WxPython on your computer from internet.</td> </tr> <tr > <td >3</td> <td >Run the jet creator from command prompt</td> </tr> <tr > <td >4</td> <td >Create Jet content and then save it</td> </tr> <tr > <td >5</td> <td >Run the application and verify the results</td> </tr> </tbody> </table> <h2 >Using JetCreator</h2> <h3 >Installing python</h3> The first step that you need while using JetCreator is to install the python. The python can be installed from its official website<a href="http://python.org/" >here</a>or from any where else on the internet. Please keep in mind the version number of the python should either be 2.6 or 2.7 because this example follows that. Once you download python install it. After installing you have to set path to the python. Open your command prompt and type the following command.It is shown in the image below: <img alt="Android Jet Player Tutorial" src="http://www.tutorialspoint.com/android/images/python0.jpg" /> Once path is set , you can verify it by typing python and hit enter. It is shown below: <img alt="Android Jet Player Tutorial" src="http://www.tutorialspoint.com/android/images/python1.jpg" /> <h3 >Installing WxPython</h3> The next thing you need to do is to install the wxPython. It can be downloaded<a href="http://www.wxpython.org/download.php" rel="nofollow" target="_blank">here</a>. Once downloaded , you will install it. It will be automatically installed in the python directory. <h3 >Ruuning JetCreator</h3> The next thing you need to is to move to the path where JetCreator is present. It is in the tools,SDK folder of the android. It is shown below − <img alt="Android Jet Player Tutorial" src="http://www.tutorialspoint.com/android/images/python.jpg" /> Once in the folder type this command and hit enter. <pre class="prettyprint prettyprinted" > python JetCreator.py</pre> It is shown in the figure below: <img alt="Android Jet Player Tutorial" src="http://www.tutorialspoint.com/android/images/python2.jpg" /> As soon as you hit enter, Jet Creator window will open. It would be something like this. <img alt="Android Jet Player Tutorial" src="http://www.tutorialspoint.com/android/images/android_jetplayer1.jpg" /> <h3 >Creating JetContent</h3> In the above Jet Window, click on the import button. And select JetCreator_demo_1 or 2 from the JetFolder from the demo content folder in the Jet folder. It is shown in the image below: <img alt="Android Jet Player Tutorial" src="http://www.tutorialspoint.com/android/images/android_jetplayer2.jpg" /> Once you import the content , you will see the content in the JetCreator window. It is shown below: <img alt="Android Jet Player Tutorial" src="http://www.tutorialspoint.com/android/images/android_jetplayer3.jpg" /> Now you can explore different options of JetCreator by visiting the JetCreator link<a href="http://developer.android.com/guide/topics/media/jet/jetcreator_manual.html" rel="nofollow" target="_blank">here</a>. Finally in order to create .jet file , you need to save the content from the file menu. <h2 >Verifying Results</h2> Once you got the jet file, you can play it using jet player. The main code of playing it has been given below − <pre class="prettyprint notranslate prettyprinted" > JetPlayer jetPlayer = JetPlayer.getJetPlayer(); jetPlayer.loadJetFile("/sdcard/level1.jet"); byte segmentId = 0; // queue segment 5, repeat once, use General MIDI, transpose by -1 octave jetPlayer.queueJetSegment(5, -1, 1, -1, 0, segmentId++); jetPlayer.play();</pre>