소리의 볼륨 변경

요약

소리의 볼륨을 변경합니다.

운영 환경

필수 구성 요소

운영 환경

샘플로 작업하는 방법

물질

참고: 이 팁은 XNA Game Studio 2.0을 기준으로 합니다.

밭

/// <summary>
/// オーディオカテゴリー
/// </summary>
private AudioCategory audioCategory;

사운드의 볼륨을 변경하려면 "AudioCategory"를 통해 변경하십시오. 이 카테고리는 AudioEngine에서 가져온 것입니다.

카테고리 검색

// XACT で作成してあるカテゴリー名を指定してカテゴリーを取得
this.audioCategory = this.audioEngine.GetCategory("Default");

카테고리는 "AudioEngine.GetCategory" 메서드를 사용하여 검색됩니다. 메서드에 지정하는 이름은 XACT에서 프로젝트를 만들 때 범주의 이름입니다. 기본적으로 "기본"과 "음악"이 생성되므로 특히 편집하지 않는 경우 어느 쪽이든 지정하십시오.

AudioEngine.GetCategory 메서드

오디오 범주를 가져옵니다.

볼륨 수정

// ボリュームは 0.0 ～ 2.0 の間に収める
this.volume = MathHelper.Clamp(this.volume, 0.0f, 2.0f);

// ボリュームをセット
this.audioCategory.SetVolume(this.volume);

사운드의 볼륨을 변경하려면 "AudioCategory.SetVolume" 메서드를 사용합니다. 인수는 볼륨으로 설정됩니다. 지정할 수 있는 범위는 0.0 ~입니다. 값의 기준은 다음과 같습니다.

AudioCategory.SetVolume 메서드

범주와 연결된 모든 소리의 볼륨을 설정합니다.

모든 코드

using System;
using System.Collections.Generic;
using Microsoft.Xna.Framework;
using Microsoft.Xna.Framework.Audio;
using Microsoft.Xna.Framework.Content;
using Microsoft.Xna.Framework.GamerServices;
using Microsoft.Xna.Framework.Graphics;
using Microsoft.Xna.Framework.Input;
using Microsoft.Xna.Framework.Net;
using Microsoft.Xna.Framework.Storage;

namespace ChangeSoundVolume
{
    /// <summary>
    /// ゲームメインクラス
    /// </summary>
    public class GameMain : Microsoft.Xna.Framework.Game
    {
        /// <summary>
        /// グラフィックデバイス管理クラス
        /// </summary>
        private GraphicsDeviceManager graphics = null;

        /// <summary>
        /// スプライトのバッチ化クラス
        /// </summary>
        private SpriteBatch spriteBatch = null;

        /// <summary>
        /// スプライトでテキストを描画するためのフォント
        /// </summary>
        private SpriteFont font = null;

        /// <summary>
        /// オーディオエンジン
        /// </summary>
        private AudioEngine audioEngine = null;

        /// <summary>
        /// WaveBank
        /// </summary>
        private WaveBank waveBank = null;

        /// <summary>
        /// SoundBank
        /// </summary>
        private SoundBank soundBank = null;

        /// <summary>
        /// オーディオカテゴリー
        /// </summary>
        private AudioCategory audioCategory;

        /// <summary>
        /// サウンドのボリューム
        /// </summary>
        private float volume = 1.0f;

        /// <summary>
        /// 直線のキーボード入力の状態
        /// </summary>
        private KeyboardState oldKeyboardState = new KeyboardState();

        /// <summary>
        /// 直線のゲームパッド入力の状態
        /// </summary>
        private GamePadState oldGamePadState = new GamePadState();


        /// <summary>
        /// GameMain コンストラクタ
        /// </summary>
        public GameMain()
        {
            // グラフィックデバイス管理クラスの作成
            this.graphics = new GraphicsDeviceManager(this);

            // ゲームコンテンツのルートディレクトリを設定
            this.Content.RootDirectory = "Content";
        }

        /// <summary>
        /// ゲームが始まる前の初期化処理を行うメソッド
        /// グラフィック以外のデータの読み込み、コンポーネントの初期化を行う
        /// </summary>
        protected override void Initialize()
        {
            // オーディオデータの読み込み
            this.audioEngine = new AudioEngine(@"Content\Audio.xgs");
            this.waveBank = new WaveBank(this.audioEngine, @"Content\Wave Bank.xwb");
            this.soundBank = new SoundBank(this.audioEngine, @"Content\Sound Bank.xsb");

            // XACT で作成してあるカテゴリー名を指定してカテゴリーを取得
            this.audioCategory = this.audioEngine.GetCategory("Default");

            // コンポーネントの初期化などを行います
            base.Initialize();
        }

        /// <summary>
        /// ゲームが始まるときに一回だけ呼ばれ
        /// すべてのゲームコンテンツを読み込みます
        /// </summary>
        protected override void LoadContent()
        {
            // テクスチャーを描画するためのスプライトバッチクラスを作成します
            this.spriteBatch = new SpriteBatch(this.GraphicsDevice);

            // フォントをコンテンツパイプラインから読み込む
            this.font = this.Content.Load<SpriteFont>("Font");
        }

        /// <summary>
        /// ゲームが終了するときに一回だけ呼ばれ
        /// すべてのゲームコンテンツをアンロードします
        /// </summary>
        protected override void UnloadContent()
        {
            // TODO: ContentManager で管理されていないコンテンツを
            //       ここでアンロードしてください
        }

        /// <summary>
        /// 描画以外のデータ更新等の処理を行うメソッド
        /// 主に入力処理、衝突判定などの物理計算、オーディオの再生など
        /// </summary>
        /// <param name="gameTime">このメソッドが呼ばれたときのゲーム時間</param>
        protected override void Update(GameTime gameTime)
        {
            // キーボードの情報取得
            KeyboardState keyboargState = Keyboard.GetState();

            // ゲームパッドの情報取得
            GamePadState gamePadState = GamePad.GetState(PlayerIndex.One);

            // Xbox360 コントローラの BACK ボタンを押したときにゲームを終了させます
            if (gamePadState.Buttons.Back == ButtonState.Pressed)
            {
                this.Exit();
            }

            if ((keyboargState.IsKeyDown(Keys.A) && this.oldKeyboardState.IsKeyUp(Keys.A)) ||
                (gamePadState.Buttons.A == ButtonState.Pressed &&
                    this.oldGamePadState.Buttons.A == ButtonState.Released))
            {
                // サウンドを再生
                this.soundBank.PlayCue("Sample");
            }

            // キー操作でボリューム変更
            if (keyboargState.IsKeyDown(Keys.Left))
            {
                this.volume += -1.0f * (float)gameTime.ElapsedGameTime.TotalSeconds;
            }
            if (keyboargState.IsKeyDown(Keys.Right))
            {
                this.volume += 1.0f * (float)gameTime.ElapsedGameTime.TotalSeconds;
            }
            if (gamePadState.IsConnected)
            {
                this.volume += gamePadState.ThumbSticks.Left.X *
                               (float)gameTime.ElapsedGameTime.TotalSeconds;
            }

            // ボリュームは 0.0 ～ 2.0 の間に収める
            this.volume = MathHelper.Clamp(this.volume, 0.0f, 2.0f);

            // ボリュームをセット
            this.audioCategory.SetVolume(this.volume);

            // 入力状態を記憶
            this.oldKeyboardState = keyboargState;
            this.oldGamePadState = gamePadState;

            // 登録された GameComponent を更新する
            base.Update(gameTime);
        }

        /// <summary>
        /// 描画処理を行うメソッド
        /// </summary>
        /// <param name="gameTime">このメソッドが呼ばれたときのゲーム時間</param>
        protected override void Draw(GameTime gameTime)
        {
            // 画面を指定した色でクリアします
            this.GraphicsDevice.Clear(Color.CornflowerBlue);

            // スプライトの描画準備
            this.spriteBatch.Begin();

            // ボリューム
            this.spriteBatch.DrawString(this.font,
                "Volume : " + this.volume,
                new Vector2(50.0f, 50.0f), Color.White);

            // 操作
            this.spriteBatch.DrawString(this.font,
                "A     : Play Sound\r\n" +
                "Left  : Volume Down\r\n" +
                "Right : Volume Up",
                new Vector2(50.0f, 80.0f), Color.White);

            // スプライトの一括描画
            this.spriteBatch.End();

            // 登録された DrawableGameComponent を描画する
            base.Draw(gameTime);
        }
    }
}