Android - JetPlayer
Android 平台包含一个 JET 引擎,可让您在应用程序中添加 JET 音频内容的交互式播放。 Android 提供了 JetPlayer 类来处理这些东西。
为了使用 Jet 内容,您需要使用 AndroidSDK 附带的 JetCreator 工具。 jetCreator 的用法已在示例中进行了讨论。 要播放 JetCreator 创建的内容,您需要 android 支持的 JetPlayer 类。
为了使用 JetPlayer ,您需要实例化一个 JetPlayer 类的对象。 它的语法如下 −
JetPlayer jetPlayer = JetPlayer.getJetPlayer();
接下来你需要做的是调用 loadJetFile 方法并传入你的 Jet 文件的路径。 之后,您必须将其添加到 JetPlayer 的队列中。 它的语法如下 −
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++);
方法 queueJetSegment 在 JET Queue 中对指定的段进行排队。 您需要做的最后一件事是调用 play 方法开始播放音乐。 它的语法如下 −
jetPlayer.play();
除了这些方法之外,JetPlayer 类中还定义了其他方法。 它们定义如下 −
序号 | 方法 & 描述 |
---|---|
1 | clearQueue() 清空片段队列,并清除所有计划播放的剪辑 |
2 | closeJetFile() 关闭包含 JET 内容的资源 |
3 | getJetPlayer() JetPlayer 类的工厂方法 |
4 | loadJetFile(String path) 从给定路径加载 .jet 文件 |
5 | pause() 暂停播放 JET 段队列 |
6 | release() 停止当前的 JET 播放,并释放所有关联的原生资源 |
示例
以下示例演示了使用 JetCreator 工具创建 Jet 内容。 创建该内容后,您可以通过 JetPlayer 播放它。
要试验此示例,您需要在实际设备或模拟器中运行它。
步骤 | 描述 |
---|---|
1 | 您将使用 Android Studio IDE 创建一个 Android 应用程序,并将其命名为 JetPlayer,位于 com.example.jetplayer 包下。 |
2 | 从 Internet 在您的计算机上安装 Python 和 WxPython。 |
3 | 从命令提示符运行 jet creator |
4 | 创建 Jet 内容,然后保存 |
5 | 运行应用程序并验证结果 |
使用 JetCreator
安装 python
使用 JetCreator 时需要的第一步是安装 python。 可以从其官方网站 http://python.org/ 或互联网上的任何其他地方安装 python。
请记住,python 的版本号应该是 2.6 或 2.7,因为此示例如下所示。
一旦你下载了 python 安装它。 安装后,您必须设置 python 的路径。 打开命令提示符并键入以下命令。如下图所示 −
设置路径后,您可以通过键入 python 并按 Enter 来验证它。 如下图所示 −
安装 WxPython
您需要做的下一件事是安装 wxPython。 它可以在http://www.wxpython.org/download.php下载。下载后,您将安装它。 它将自动安装在 python 目录中。
运行 JetCreator
您需要做的下一件事是移动到 JetCreator 所在的路径。 它在 android 的工具,SDK 文件夹中。 如下图所示 −
进入文件夹后,键入此命令并按 Enter。
python JetCreator.py
如下图所示 −
按下 Enter 键后,Jet Creator 窗口将打开。 会是这样的。
创建 JetContent
在上面的 Jet 窗口中,单击导入按钮。 并从 Jet 文件夹中的演示内容文件夹中的 JetFolder 中选择 JetCreator_demo_1 或 2。 如下图所示:
导入内容后,您将在 JetCreator 窗口中看到内容。 如下图所示 −
现在您可以通过访问 JetCreator 链接来探索 JetCreator 的不同选项 http://developer.android.com/guide/topics/media/jet/jetcreator_manual.html。 最后,为了创建 .jet 文件,您需要从文件菜单中保存内容。
验证结果
获得 jet 文件后,您可以使用 jet 播放器播放它。 播放它的主要代码如下 −
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();