public final class MidiDevice
extends Object
implements Closeable
java.lang.Object | |
↳ | android.media.midi.MidiDevice |
此类用于向MIDI设备发送数据和从MIDI设备接收数据本类的实例由 openDevice(MidiDeviceInfo, MidiManager.OnDeviceOpenedListener, Handler)
创建。
Nested classes |
|
---|---|
class |
MidiDevice.MidiConnection 该类表示一个设备的输出端口与另一个设备的输入端口之间的连接。 |
Public methods |
|
---|---|
void |
close() 关闭此流并释放与其关联的所有系统资源。 |
MidiDevice.MidiConnection |
connectPorts(MidiInputPort inputPort, int outputPortNumber) 使用指定的端口号将提供的 |
MidiDeviceInfo |
getInfo() 返回描述此设备的 |
MidiInputPort |
openInputPort(int portNumber) 打电话给指定端口号打开 |
MidiOutputPort |
openOutputPort(int portNumber) 打电话给指定端口号打开 |
String |
toString() 返回对象的字符串表示形式。 |
Protected methods |
|
---|---|
void |
finalize() 当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface java.io.Closeable
|
|
From interface java.lang.AutoCloseable
|
void close ()
关闭此流并释放与其关联的所有系统资源。 如果流已经关闭,则调用此方法不起作用。
Throws | |
---|---|
IOException |
MidiDevice.MidiConnection connectPorts (MidiInputPort inputPort, int outputPortNumber)
使用指定的端口号将提供的MidiInputPort
连接到此设备的输出端口。 连接完成后,MidiInput端口实例不能再通过其方法onSend(byte[], int, int, long)
接收数据。 此方法返回一个MidiDevice.MidiConnection
对象,该对象可用于关闭连接。
Parameters | |
---|---|
inputPort |
MidiInputPort : the inputPort to connect |
outputPortNumber |
int : the port number of the output port to connect inputPort to. |
Returns | |
---|---|
MidiDevice.MidiConnection |
MidiDevice.MidiConnection object if the connection is successful, or null in case of failure. |
MidiDeviceInfo getInfo ()
返回描述此设备的 MidiDeviceInfo
对象。
Returns | |
---|---|
MidiDeviceInfo |
the MidiDeviceInfo object |
MidiInputPort openInputPort (int portNumber)
打电话给指定端口号打开MidiInputPort
。 输入端口一次只能由一个发件人使用。 如果另一个应用程序已将其打开以供使用,则打开输入端口将失败。 A MidiDeviceStatus
可用于确定输入端口是否已打开。
Parameters | |
---|---|
portNumber |
int : the number of the input port to open |
Returns | |
---|---|
MidiInputPort |
the MidiInputPort if the open is successful, or null in case of failure. |
MidiOutputPort openOutputPort (int portNumber)
打电话给指定端口号打开MidiOutputPort
。 输出端口可以由多个应用程序打开。
Parameters | |
---|---|
portNumber |
int : the number of the output port to open |
Returns | |
---|---|
MidiOutputPort |
the MidiOutputPort if the open is successful, or null in case of failure. |
String toString ()
返回对象的字符串表示形式。 通常, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void finalize ()
当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。 子类会覆盖finalize
方法来处置系统资源或执行其他清理。
的常规协定finalize
是,它被调用,如果当在Java TM虚拟机已确定不再有由该目的可以通过还没有死亡,除了作为一个动作的结果的任何线程访问的任何手段取决于某些其他可以完成的对象或类别的最终定稿。 finalize
方法可以采取任何行动,包括使这个对象再次可用于其他线程; 然而, finalize
的通常目的是在对象被不可撤销地丢弃之前执行清除操作。 例如,表示输入/输出连接的对象的finalize方法可能会执行显式I / O事务,以在永久丢弃该对象之前中断连接。
类Object
的finalize
方法Object
执行特殊操作; 它只是正常返回。 Object
子类可能会覆盖此定义。
Java编程语言不保证哪个线程将为任何给定的对象调用finalize
方法。 但是,保证调用finalize的线程在调用finalize时不会保留任何用户可见的同步锁。 如果finalize方法引发未捕获的异常,则忽略该异常,并终止该对象的终止。
在针对对象调用 finalize
方法之后,不会采取进一步的操作,直到Java虚拟机再次确定不再有任何途径可以通过尚未死亡的任何线程访问此对象,包括可能的操作通过准备完成的其他对象或类别,此时该对象可能被丢弃。
对于任何给定的对象,Java虚拟机从不会多次调用 finalize
方法。
finalize
方法引发的任何异常 finalize
导致终止此对象的终止,但会被忽略。
Throws | |
---|---|
Throwable |