public class Ringtone
extends Object
| java.lang.Object | |
| ↳ | android.media.Ringtone |
铃声提供了播放铃声，通知或其他类似声音的快速方法。
有关检索 Ringtone对象或显示铃声选择器的方法，请参见 RingtoneManager 。
也可以看看：
Public methods |
|
|---|---|
AudioAttributes |
getAudioAttributes() 返回此对象使用的 |
int |
getStreamType() 此方法在API级别21中已弃用。不推荐使用流类型，请参见 |
String |
getTitle(Context context) 返回铃声的人物形象标题。 |
boolean |
isPlaying() 这个铃声是否正在播放。 |
void |
play() 播放铃声。 |
void |
setAudioAttributes(AudioAttributes attributes) 为此铃声设置 |
void |
setStreamType(int streamType) 此方法在API级别21中已弃用。请使用 |
void |
stop() 停止播放铃声。 |
Protected methods |
|
|---|---|
void |
finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
AudioAttributes getAudioAttributes ()
返回此对象使用的 AudioAttributes 。
| Returns | |
|---|---|
AudioAttributes |
the AudioAttributes that were set with setAudioAttributes(AudioAttributes) or the default attributes if none were set. |
int getStreamType ()
此方法在API级别21中已弃用。
不赞成使用流类型，请参阅setAudioAttributes(AudioAttributes)
获取此铃声将播放的流类型。
| Returns | |
|---|---|
int |
The stream type, see AudioManager. |
String getTitle (Context context)
返回铃声的人物形象标题。 在媒体内容提供商看。 如果不在其中，则使用文件名
| Parameters | |
|---|---|
context |
Context: A context used for querying. |
| Returns | |
|---|---|
String |
|
boolean isPlaying ()
这个铃声是否正在播放。
| Returns | |
|---|---|
boolean |
True if playing, false otherwise. |
void setAudioAttributes (AudioAttributes attributes)
为此铃声设置 AudioAttributes 。
| Parameters | |
|---|---|
attributes |
AudioAttributes: the non-null attributes characterizing this ringtone. |
| Throws | |
|---|---|
IllegalArgumentException |
|
void setStreamType (int streamType)
此方法在API级别21中已弃用。
使用setAudioAttributes(AudioAttributes)
设置将播放此铃声的流类型。
| Parameters | |
|---|---|
streamType |
int: The stream, see AudioManager. |
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导致此对象的终止被暂停，但是会被忽略。
Android开发手册