【应用场景】

在客户端完成某个操作后，播放提示音。

【注意】

<1>仅支持MP3格式的音频文件

<2>支持本地文件（mp3文件存放在应用服务器的Kingdee\K3Cloud\WebSite\Audio文件夹中）和网络文件（仅支持http协议）。

<3>本地文件可在客户端和SL端正常播放，网络文件仅可在客户端正常播放，H5端不支持音频控件播放提示音。

【案例演示】

采购订单，新增音频控件，通过插件控制，输出不同的提示音。

【实现步骤】

<1>编写表单插件，代码如下。

using Kingdee.BOS.Core.DynamicForm.PlugIn;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Util;
using System.ComponentModel;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【表单插件】音频控件
    /// </summary>
    [Description("【表单插件】音频控件"), HotUpdate]
    public class AudioPlayFormPlugIn : AbstractDynamicFormPlugIn
    {
        public override void BarItemClick(BarItemClickEventArgs e)
        {
            base.BarItemClick(e);
            var audioPlay = this.View.GetControl("F_Jac_AudioPlay");
            if (e.BarItemKey.Contains("test1"))
            {
                // 播放默认地址的音频文件
                this.View.ShowMessage("播放默认提示音");
                audioPlay.InvokeControlMethod("Play");
                //audioPlay.SetCustomPropertyValue("AudioOnServer", "Audio/ok.mp3");
                //audioPlay.InvokeControlMethod("Play");
            }
            if (e.BarItemKey.Contains("test2"))
            {
                // 播放指定地址的音频文件
                this.View.ShowMessage("播放错误提示音");
                audioPlay.SetCustomPropertyValue("AudioOnServer", "Audio/error.mp3");
                audioPlay.InvokeControlMethod("Play");
            }
            if (e.BarItemKey.Contains("test3"))
            {
                // 播放网络地址的音频文件
                // https://www.tukuppt.com/yinxiao/
                this.View.ShowMessage("播放网络提示音");
                audioPlay.SetCustomPropertyValue("AudioOnServer", "http://img.tukuppt.com/newpreview_music/09/00/62/5c893bcaf3c9980553.mp3");
                audioPlay.InvokeControlMethod("Play");
            }
        }
    }
}

<2>拷贝插件组件到应用站点的WebSite\Bin目录下，重启IIS。

<3>拷贝音频文件到金蝶云星空安装目录下的WebSite\Audio文件夹。

<4>BOSIDE扩展采购订单，新增音频控件，菜单集合新增菜单项，注册表单插件，保存元数据，开发完毕。

【功能验证】

<1>登录业务站点，打开采购订单新增界面，点击菜单test1，test2，test3，即可播放不同的提示音。

---------------------------------------------------------------------------------------------------------

【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696