Android 简明教程

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 队列中。最后,你需要调用 play 方法来播放音乐。其语法如下所示 -

jetPlayer.play();

除了这些方法以外,JetPlayer 类中还定义了其他方法。它们在下面定义 -

Sr.No

Method & description

1

clearQueue() 清空片段队列,并清除所有计划播放的片段

2

closeJetFile() 关闭包含 JET 内容的资源

3

getJetPlayer() JetPlayer 类工厂方法

4

loadJetFile(String path) 从给定路径加载 .jet 文件

5

pause() 暂停 JET 片段队列的播放

6

release() 停止当前的 JET 播放,并释放所有相关的本机资源

Example

以下示例演示了如何使用 JetCreator 工具创建 Jet 内容。一旦该内容创建,你可以通过 JetPlayer 播放它。

要使用此示例,你需要在实际设备或模拟器上运行它。

Steps

Description

1

你将使用 Android Studio IDE 创建一个 Android 应用程序,并将其命名为 JetPlayer,包名为 com.example.jetplayer。

2

从网上在计算机上安装 Python 和 WxPython。

3

从命令提示符运行 jet creator

4

创建 Jet 内容然后保存

5

运行应用程序并验证结果

Using JetCreator

Installing python

使用 JetCreator 时所需的第一步是安装 python。可以从其官方网站 here 或互联网上其他任何地方安装 python。

请记住,python 的版本号应为 2.6 或 2.7,因为本示例遵循该版本。

下载 python 后安装它。安装后,你必须设置 python 的路径。打开命令提示符并键入以下命令。它显示在下面的图像中 -

python0

设定路径后你可以通过输入 python 并按下回车键验证。如下图所示 -

python1

Installing WxPython

下一步你需要做的是安装 wxPython。可以 here 下载。下载之后,你会安装它。它会自动安装在 python 目录中。

Ruuning JetCreator

下一步你需要做的是移动到 JetCreator 所在的路径。它在 android 工具的 SDK 文件夹中。如下图所示 -

python

到文件夹后输入此命令并按下回车键。

python JetCreator.py

如下图所示 -

python2

只要你按下回车键,Jet Creator 窗口就会打开。它会是这样的。

android jetplayer1

Creating JetContent

在上面的 Jet 窗口中,点击导入按钮。从 Jet 文件夹中选择 JetCreator_demo_1 或 2,在 Jet 文件夹的 demo 内容文件夹中。如下图所示:

android jetplayer2

一旦你导入内容,你就会在 JetCreator 窗口中看到内容。如下图所示 -

android jetplayer3

现在你可以通过访问 JetCreator 链接 here 探索 JetCreator 的不同选项。最后为了创建 .jet 文件,你需要从文件菜单中保存内容。

Verifying Results

一旦你得到 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();