wp_audio_shortcode()


WordPressのwp_audio_shortcode()関数は、オーディオファイルをショートコードとして埋め込むために使用されます。この関数は、オーディオプレーヤーを生成し、指定されたオーディオファイルを再生するためのHTMLを返します。

構文

wp_audio_shortcode( array $attr );

引数の説明:

  • $attr(array) — オーディオプレーヤーの属性を指定する連想配列。以下のキーを持つことができます：
    • src — オーディオファイルのURL。
    • loop — オーディオをループ再生するかどうか。
    • autoplay — ページ読み込み時に自動再生するかどうか。
    • preload — オーディオファイルのプリロード方法を指定します。
    • class — オーディオプレーヤーに適用するCSSクラス。

例1: 基本的なオーディオプレーヤーの表示

この例では、単一のオーディオファイルを再生するためのプレーヤーを表示します。

<?php echo wp_audio_shortcode( array( 'src' => 'http://example.com/audio.mp3' ) ); ?>

例2: ループ再生と自動再生の設定

この例では、オーディオをループ再生し、ページ読み込み時に自動再生するように設定します。

<?php echo wp_audio_shortcode( array( 'src' => 'http://example.com/audio.mp3', 'loop' => 'on', 'autoplay' => 'on' ) ); ?>

例3: プリロードの設定

この例では、オーディオファイルをメタデータのみプリロードするように設定します。

<?php echo wp_audio_shortcode( array( 'src' => 'http://example.com/audio.mp3', 'preload' => 'metadata' ) ); ?>

例4: CSSクラスの追加

この例では、オーディオプレーヤーにカスタムCSSクラスを追加します。

<?php echo wp_audio_shortcode( array( 'src' => 'http://example.com/audio.mp3', 'class' => 'custom-audio-class' ) ); ?>

例5: 複数のオーディオファイルの再生

この例では、複数のオーディオファイルを再生するためのプレーヤーを表示します。

<?php echo wp_audio_shortcode( array( 'src' => array( 'http://example.com/audio1.mp3', 'http://example.com/audio2.mp3' ) ) ); ?>

例6: オーディオプレーヤーの幅と高さの設定

この例では、オーディオプレーヤーの幅と高さを指定します。

<?php echo wp_audio_shortcode( array( 'src' => 'http://example.com/audio.mp3', 'width' => 300, 'height' => 50 ) ); ?>

例7: オーディオプレーヤーのスタイルを変更

この例では、オーディオプレーヤーのスタイルを変更するために、カスタムCSSを適用します。

<?php echo wp_audio_shortcode( array( 'src' => 'http://example.com/audio.mp3', 'style' => 'background-color: #f0f0f0;' ) ); ?>

例8: オーディオプレーヤーのコントロールを非表示にする

この例では、オーディオプレーヤーのコントロールを非表示にします。

<?php echo wp_audio_shortcode( array( 'src' => 'http://example.com/audio.mp3', 'controls' => 'off' ) ); ?>

注意点

  • オーディオファイルのURLが正しく指定されていることを確認してください。
  • 自動再生は、一部のブラウザではユーザーの設定によって無効化されることがあります。
  • プリロードの設定は、ブラウザのサポート状況によって異なる場合があります。

関連機能：