Most visited

Recently visited

Results for

Added in API level 1
Summary: Constants | Ctors | Methods | Inherited Methods | [Expand All]

RingtoneManager

public class RingtoneManager
extends Object

java.lang.Object
   ↳ android.media.RingtoneManager

铃声管理器提供对铃声，通知和其他类型的声音的访问。 它管理查询不同的媒体提供商并将结果合并到单个光标中。 它还为每个铃声提供Ringtone 。 我们通常将这些声音称为铃声，但是TYPE_RINGTONE指的是适用于电话铃声的声音类型。

要向用户显示铃声选择器，请使用 ACTION_RINGTONE_PICKER意图启动选取器作为子活动。

也可以看看：

Summary

Constants
String ACTION_RINGTONE_PICKER

活动操作：显示铃声选择器。
String EXTRA_RINGTONE_DEFAULT_URI

给铃声选择器作为 Uri 。
String EXTRA_RINGTONE_EXISTING_URI

给铃声选择器作为 Uri 。
String EXTRA_RINGTONE_INCLUDE_DRM

此常数在API级别19中已弃用。不再支持DRM铃声
String EXTRA_RINGTONE_PICKED_URI

从铃声选择器作为 Uri 。
String EXTRA_RINGTONE_SHOW_DEFAULT

给铃声选择器作为布尔值。
String EXTRA_RINGTONE_SHOW_SILENT

给铃声选择器作为布尔值。
String EXTRA_RINGTONE_TITLE

给铃声选择器作为 CharSequence 。
String EXTRA_RINGTONE_TYPE

将铃声选择器设为int。
int ID_COLUMN_INDEX

列索引（在游标 getCursor()为游标ID返回的游标中。
int TITLE_COLUMN_INDEX

列索引（在标题中由 getCursor()返回的游标中）。
int TYPE_ALARM

指代用于警报的声音的类型。
int TYPE_ALL

所有类型的声音。
int TYPE_NOTIFICATION

指代用于通知的声音的类型。
int TYPE_RINGTONE

类型是指用于电话铃声的声音。
int URI_COLUMN_INDEX

列索引（在游标提供者的URI中，由 getCursor()返回的游标中）。

Public constructors
RingtoneManager(Activity activity)

构造铃声管理器。
RingtoneManager(Context context)

构造铃声管理器。

Public methods
static Uri getActualDefaultRingtoneUri(Context context, int type)

获取当前的默认声音 Uri 。
Cursor getCursor()

返回所有可用铃声的 Cursor 。
static int getDefaultType(Uri defaultRingtoneUri)

返回默认 Uri的类型。
static Uri getDefaultUri(int type)

返回 Uri作为特定类型的默认铃声。
boolean getIncludeDrm()

此方法在API级别19中已弃用。不再支持DRM铃声
static Ringtone getRingtone(Context context, Uri ringtoneUri)

返回给定声音URI的 Ringtone 。
Ringtone getRingtone(int position)

获取 Ringtone中给定位置的铃声的 Cursor 。
int getRingtonePosition(Uri ringtoneUri)

获取的位置 Uri这个范围内 RingtoneManager 。
Uri getRingtoneUri(int position)

获取 Uri中给定位置的铃声的 Cursor 。
boolean getStopPreviousRingtone()
static Uri getValidRingtoneUri(Context context)

返回有效的铃声URI。
int inferStreamType()

根据此管理器返回的铃声类型推断播放流类型。
static boolean isDefault(Uri ringtoneUri)

返回给定的 Uri是否是默认铃声之一。
static void setActualDefaultRingtoneUri(Context context, int type, Uri ringtoneUri)

设置给定声音类型的默认声音的 Uri 。
void setIncludeDrm(boolean includeDrm)

此方法在API级别19中已弃用。不再支持DRM铃声
void setStopPreviousRingtone(boolean stopPreviousRingtone)

是否检索另一个 Ringtone将停止播放之前检索到的 Ringtone 。
void setType(int type)

设置哪种类型的铃声将由此列出。
void stopPreviousRingtone()

停止播放 Ringtone获取的最后 Ringtone 。

Inherited methods
From class java.lang.Object

Constants

ACTION_RINGTONE_PICKER

Added in API level 1 
String ACTION_RINGTONE_PICKER

活动操作：显示铃声选择器。

输入： EXTRA_RINGTONE_EXISTING_URI ， EXTRA_RINGTONE_SHOW_DEFAULT ， EXTRA_RINGTONE_SHOW_SILENT ， EXTRA_RINGTONE_TYPE ， EXTRA_RINGTONE_DEFAULT_URI ， EXTRA_RINGTONE_TITLE ，

输出： EXTRA_RINGTONE_PICKED_URI 。

常量值：“android.intent.action.RINGTONE_PICKER”

EXTRA_RINGTONE_DEFAULT_URI

Added in API level 1 
String EXTRA_RINGTONE_DEFAULT_URI

给铃声选择器作为Uri 。 当用户尝试预览“默认”铃声时播放铃声的Uri 。 这可以是一个DEFAULT_RINGTONE_URI ， DEFAULT_NOTIFICATION_URI ，或DEFAULT_ALARM_ALERT_URI有“默认”点到当前的声音对于给定的默认声音类型。 如果您显示某种其他类型的铃声选择器，则可以在此处免费提供任何Uri 。

常量值：“android.intent.extra.ringtone.DEFAULT_URI”

EXTRA_RINGTONE_EXISTING_URI

Added in API level 1 
String EXTRA_RINGTONE_EXISTING_URI

给铃声选择器作为Uri 。 当前铃声的Uri ，这将用于显示此Uri的项目旁边的复选标记。 如果表示“默认”（@see项EXTRA_RINGTONE_SHOW_DEFAULT ），这也可以是一个DEFAULT_RINGTONE_URI ， DEFAULT_NOTIFICATION_URI ，或DEFAULT_ALARM_ALERT_URI具有“默认”项检查。

也可以看看：

常量值：“android.intent.extra.ringtone.EXISTING_URI”

EXTRA_RINGTONE_INCLUDE_DRM

Added in API level 1 
String EXTRA_RINGTONE_INCLUDE_DRM

此常数在API级别19中已弃用。
DRM铃声不再受支持

给铃声选择器作为布尔值。 是否包含DRM铃声。

常量值：“android.intent.extra.ringtone.INCLUDE_DRM”

EXTRA_RINGTONE_PICKED_URI

Added in API level 1 
String EXTRA_RINGTONE_PICKED_URI

从铃声选择器作为 Uri 。

它将是以下之一：

  • the picked ringtone,
  • a Uri that equals DEFAULT_RINGTONE_URI, DEFAULT_NOTIFICATION_URI, or DEFAULT_ALARM_ALERT_URI if the default was chosen,
  • null if the "Silent" item was picked.

    也可以看看：

    常量值：“android.intent.extra.ringtone.PICKED_URI”

    • EXTRA_RINGTONE_SHOW_DEFAULT

    Added in API level 1 
    String EXTRA_RINGTONE_SHOW_DEFAULT

    给铃声选择器作为布尔值。 是否显示“默认”项目。

    也可以看看：

    常量值：“android.intent.extra.ringtone.SHOW_DEFAULT”

    EXTRA_RINGTONE_SHOW_SILENT

    Added in API level 1 
    String EXTRA_RINGTONE_SHOW_SILENT

    给铃声选择器作为布尔值。 是否显示“无声”项目。 如果选择“无声”项目，则EXTRA_RINGTONE_PICKED_URI将为空。

    也可以看看：

    常量值：“android.intent.extra.ringtone.SHOW_SILENT”

    EXTRA_RINGTONE_TITLE

    Added in API level 1 
    String EXTRA_RINGTONE_TITLE

    给铃声选择器作为CharSequence 。 为铃声选择器显示的标题。 这有一个适用于大多数情况下的默认值。

    常量值：“android.intent.extra.ringtone.TITLE”

    EXTRA_RINGTONE_TYPE

    Added in API level 1 
    String EXTRA_RINGTONE_TYPE

    将铃声选择器设为int。 指定哪些铃声类型应该在选取器中显示。 一个或一个以上的TYPE_RINGTONE ， TYPE_NOTIFICATION ， TYPE_ALARM ，或TYPE_ALL （按位或一起）。

    常量值：“android.intent.extra.ringtone.TYPE”

    ID_COLUMN_INDEX

    Added in API level 1 
    int ID_COLUMN_INDEX

    列索引（在游标中由 getCursor()返回的行ID。

    常量值：0（0x00000000）

    TITLE_COLUMN_INDEX

    Added in API level 1 
    int TITLE_COLUMN_INDEX

    列索引（在标题中由 getCursor()返回的游标中）。

    常数值：1（0x00000001）

    TYPE_ALARM

    Added in API level 1 
    int TYPE_ALARM

    指代用于警报的声音的类型。

    常量值：4（0x00000004）

    TYPE_ALL

    Added in API level 1 
    int TYPE_ALL

    所有类型的声音。

    常量值：7（0x00000007）

    TYPE_NOTIFICATION

    Added in API level 1 
    int TYPE_NOTIFICATION

    指代用于通知的声音的类型。

    常量值：2（0x00000002）

    TYPE_RINGTONE

    Added in API level 1 
    int TYPE_RINGTONE

    类型是指用于电话铃声的声音。

    常数值：1（0x00000001）

    URI_COLUMN_INDEX

    Added in API level 1 
    int URI_COLUMN_INDEX

    列索引（对于媒体提供程序的URI，由 getCursor()返回的游标中）。

    常量值：2（0x00000002）

    Public constructors

    RingtoneManager

    Added in API level 1 
    RingtoneManager (Activity activity)

    构造铃声管理器。 这个构造函数被推荐为它的构造实例管理游标。

    Parameters
    activity Activity: The activity used to get a managed cursor.

    RingtoneManager

    Added in API level 1 
    RingtoneManager (Context context)

    构造铃声管理器。 这个构造函数构造的实例不会管理游标，所以客户端应该自己处理它。

    Parameters
    context Context: The context to used to get a cursor.

    Public methods

    getActualDefaultRingtoneUri

    Added in API level 1 
    Uri getActualDefaultRingtoneUri (Context context, 
                int type)

    获取当前的默认声音Uri 。 这会给实际的声音Uri ，而不是使用这个，大多数客户可以使用DEFAULT_RINGTONE_URI 。

    Parameters
    context Context: A context used for querying.
    type int: The type whose default sound should be returned. One of TYPE_RINGTONE, TYPE_NOTIFICATION, or TYPE_ALARM.
    Returns
    Uri A Uri pointing to the default sound for the sound type.

    也可以看看：

    getCursor

    Added in API level 1 
    Cursor getCursor ()

    返回所有可用铃声的Cursor 。 返回的游标将是每次调用此方法时返回的相同游标，所以不要使用close()游标。 游标可以安全地为deactivate() 。

    如果没有使用 RingtoneManager(Activity) ，调用者应该通过其活动的生命周期来管理返回的游标，以防止游标泄漏。

    请注意，可用的铃声清单将根据主叫方是否具有 READ_EXTERNAL_STORAGE权限而有所不同。

    Returns
    Cursor A Cursor of all the ringtones available.

    也可以看看：

    getDefaultType

    Added in API level 1 
    int getDefaultType (Uri defaultRingtoneUri)

    返回默认 Uri的类型。

    Parameters
    defaultRingtoneUri Uri: The default Uri. For example, DEFAULT_RINGTONE_URI, DEFAULT_NOTIFICATION_URI, or DEFAULT_ALARM_ALERT_URI.
    Returns
    int The type of the defaultRingtoneUri, or -1.

    getDefaultUri

    Added in API level 1 
    Uri getDefaultUri (int type)

    为特定类型的默认铃声返回Uri 。 而不是返回实际铃声的声音Uri ，这将返回符号Uri ，这将在播放时解析为实际的声音。

    Parameters
    type int: The ringtone type whose default should be returned.
    Returns
    Uri The Uri of the default ringtone for the given type.

    getIncludeDrm

    Added in API level 1 
    boolean getIncludeDrm ()

    此方法在API级别19中已被弃用。
    DRM铃声不再受支持

    返回是否包含DRM铃声。

    Returns
    boolean Whether DRM ringtones will be included.

    也可以看看：

    getRingtone

    Added in API level 1 
    Ringtone getRingtone (Context context, 
                Uri ringtoneUri)

    为给定的声音URI返回 Ringtone 。

    如果给定的URI无法以任何理由打开，则此方法将尝试回退到另一个声音。 如果找不到，它将返回null。

    Parameters
    context Context: A context used to query.
    ringtoneUri Uri: The Uri of a sound or ringtone.
    Returns
    Ringtone A Ringtone for the given URI, or null.

    getRingtone

    Added in API level 1 
    Ringtone getRingtone (int position)

    获取 Ringtone中给定位置的铃声 Cursor 。

    Parameters
    position int: The position (in the Cursor) of the ringtone.
    Returns
    Ringtone A Ringtone pointing to the ringtone.

    getRingtonePosition

    Added in API level 1 
    int getRingtonePosition (Uri ringtoneUri)

    获取的位置 Uri这个范围内 RingtoneManager 。

    Parameters
    ringtoneUri Uri: The Uri to retreive the position of.
    Returns
    int The position of the Uri, or -1 if it cannot be found.

    getRingtoneUri

    Added in API level 1 
    Uri getRingtoneUri (int position)

    获取 Uri中给定位置的铃声 Cursor 。

    Parameters
    position int: The position (in the Cursor) of the ringtone.
    Returns
    Uri A Uri pointing to the ringtone.

    getStopPreviousRingtone

    Added in API level 1 
    boolean getStopPreviousRingtone ()

    Returns
    boolean

    也可以看看：

    getValidRingtoneUri

    Added in API level 1 
    Uri getValidRingtoneUri (Context context)

    返回有效的铃声URI。 没有保证它返回。 如果找不到，则返回null。 如果只能在外部存储中找到一个，并且调用方没有READ_EXTERNAL_STORAGE权限，则返回null。

    Parameters
    context Context: The context to use for querying.
    Returns
    Uri A ringtone URI, or null if one cannot be found.

    inferStreamType

    Added in API level 3 
    int inferStreamType ()

    根据此管理器返回的铃声类型推断播放流类型。

    Returns
    int The stream type.

    isDefault

    Added in API level 1 
    boolean isDefault (Uri ringtoneUri)

    返回给定的 Uri是否是默认铃声之一。

    Parameters
    ringtoneUri Uri: The ringtone Uri to be checked.
    Returns
    boolean Whether the Uri is a default.

    setActualDefaultRingtoneUri

    Added in API level 1 
    void setActualDefaultRingtoneUri (Context context, 
                int type, 
                Uri ringtoneUri)

    为给定声音类型设置默认声音的 Uri 。

    Parameters
    context Context: A context used for querying.
    type int: The type whose default sound should be set. One of TYPE_RINGTONE, TYPE_NOTIFICATION, or TYPE_ALARM.
    ringtoneUri Uri: A Uri pointing to the default sound to set.

    也可以看看：

    setIncludeDrm

    Added in API level 1 
    void setIncludeDrm (boolean includeDrm)

    此方法在API级别19中已被弃用。
    DRM铃声不再受支持

    设置是否包含DRM铃声。

    Parameters
    includeDrm boolean: Whether to include DRM ringtones. Obsolete - no longer has any effect

    setStopPreviousRingtone

    Added in API level 1 
    void setStopPreviousRingtone (boolean stopPreviousRingtone)

    是否检索另一个 Ringtone将停止播放之前检索到的 Ringtone 。

    如果这是错误的，请务必 stop()任何以前的铃声来释放资源。

    Parameters
    stopPreviousRingtone boolean: If true, the previously retrieved Ringtone will be stopped.

    setType

    Added in API level 1 
    void setType (int type)

    设置哪种类型的铃声将由此列出。

    Parameters
    type int: The type(s), one or more of TYPE_RINGTONE, TYPE_NOTIFICATION, TYPE_ALARM, TYPE_ALL.

    也可以看看：

    stopPreviousRingtone

    Added in API level 1 
    void stopPreviousRingtone ()

    停止播放 Ringtone获取的最后 Ringtone 。

    Android开发手册

    Hooray!