云策 WordPress 开发者社区

函数文档

wp_get_audio_extensions()

查看官方原文 ↗
💡 云策文档标注

概述

wp_get_audio_extensions() 函数返回一个经过过滤的、WordPress 支持的音频格式列表。它通过 apply_filters() 钩子允许开发者自定义默认格式。

关键要点

  • 函数返回一个字符串数组，表示支持的音频格式，默认包括 'mp3', 'ogg', 'flac', 'm4a', 'wav'。
  • 使用 apply_filters('wp_audio_extensions', $extensions) 钩子来过滤或修改支持的音频格式列表。
  • 该函数自 WordPress 3.6.0 版本引入，常用于媒体处理和短码输出等场景。

代码示例

function wp_get_audio_extensions() {
    return apply_filters( 'wp_audio_extensions', array( 'mp3', 'ogg', 'flac', 'm4a', 'wav' ) );
}
📄 原文内容

Returns a filtered list of supported audio formats.

Return

string[] Supported audio formats.

Source

function wp_get_audio_extensions() {
	/**
	 * Filters the list of supported audio formats.
	 *
	 * @since 3.6.0
	 *
	 * @param string[] $extensions An array of supported audio formats. Defaults are
	 *                            'mp3', 'ogg', 'flac', 'm4a', 'wav'.
	 */
	return apply_filters( 'wp_audio_extensions', array( 'mp3', 'ogg', 'flac', 'm4a', 'wav' ) );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘wp_audio_extensions’, string[] $extensions )

Filters the list of supported audio formats.

Uses Description
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.
Used by Description
WP_Widget_Media_Audio::get_instance_schema()wp-includes/widgets/class-wp-widget-media-audio.php

Get schema for properties of a widget instance (item).
wp_attachment_is()wp-includes/post.php

Verifies an attachment is of a given type.
wp_enqueue_media()wp-includes/media.php

Enqueues all scripts, styles, settings, and templates necessary to use all media JS APIs.
wp_maybe_load_embeds()wp-includes/embed.php

Determines if default embed handlers should be loaded.
wp_audio_shortcode()wp-includes/media.php

Builds the Audio shortcode output.
wp_underscore_audio_template()wp-includes/media-template.php

Outputs the markup for an audio tag to be used in an Underscore template when data.model is passed.
wp_print_media_templates()wp-includes/media-template.php

Prints the templates used in the media manager.

Show 2 moreShow less

Changelog

Version Description
3.6.0 Introduced.