使用C#与Unity实现Windows平台下的文件选择器

使用C#与Unity实现Windows平台下的视频文件选择器

在Unity开发过程中，我们有时需要允许用户从他们的系统中选择特定类型的文件，比如视频文件，以便进一步处理或显示。虽然Unity引擎提供了跨平台的解决方案，但在特定情况下，利用平台特定的API可以提供更灵活的功能。本文将展示如何在Unity项目中，针对Windows平台，通过C#调用Win32 API来实现一个简单的视频文件选择器。

引言

我们将使用Comdlg32.dll中的GetOpenFileName函数，这是Windows提供的用于打开文件对话框的标准方法。为了与这个底层API交互，我们需要定义一些结构体和PInvoke（Platform Invoke）方法。下面的代码示例展示了如何实现这一功能。

实现步骤

1.定义结构体

首先，定义一个与Windows API中的OPENFILENAME结构对应的C#结构体OpenFileName，并使用StructLayout和MarshalAs属性确保正确的内存布局和字符集。

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
public class OpenFileName
{
    // ...（结构体成员省略，见原始代码）
}

2.导入Win32 API

使用DllImport特性导入Comdlg32.dll中的GetOpenFileName方法。

[DllImport("Comdlg32.dll", SetLastError = true, CharSet = CharSet.Auto)]
private static extern bool GetOpenFileName([In, Out] OpenFileName ofn);

3.创建文件选择器类

创建一个名为FilePicker的MonoBehaviour脚本，它将包含用于初始化文件选择对话框和处理选择结果的方法。

public class FilePicker : MonoBehaviour
{
    private OpenFileName openFileName;

    // ...（ChooseVideo和InitializeOpenFileName方法省略，见原始代码）
}

4.初始化与调用

初始化: InitializeOpenFileName方法负责设置OpenFileName结构体的各个字段，包括过滤器、初始目录、标题等。

调用: ChooseVideo方法通过调用GetOpenFileName函数显示文件选择对话框，并处理用户的选择。

注意事项

文件类型过滤: 示例代码中，我们特别为视频文件设置了过滤器，允许用户选择常见的视频格式如.mp4, .avi, 等。
路径处理: 选择的文件路径会存储在openFileName.file中，由于该字符串末尾可能包含空字符\0，我们需要使用TrimEnd(‘\0’)进行处理。
平台兼容性: 请注意，此实现仅适用于Windows平台，且直接使用了Unity的Application.dataPath作为默认目录，这在实际应用中可能需要调整，因为用户通常不会在这个路径下存放个人文件。

总结

通过上述步骤，我们成功地在Unity项目中集成了一个简单的视频文件选择器，利用了Windows的本机API。这种方法为开发者提供了一种灵活的手段来扩展Unity项目的功能，尤其是在需要与操作系统深度集成的场景中。尽管如此，也要意识到这种实现方式的局限性，特别是跨平台兼容性问题，因此在设计时应充分考虑项目的具体需求。
完整代码如下：

using UnityEngine;
using System;
using System.Runtime.InteropServices;
using System.IO;
using UnityEngine.UI;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
public class OpenFileName
{
 public int structSize = 0;
 public IntPtr dlgOwner = IntPtr.Zero;
 public IntPtr instance = IntPtr.Zero;
 public String filter = null;
 public String customFilter = null;
 public int maxCustFilter = 0;
 public int filterIndex = 0;
 public String file = null;
 public int maxFile = 0;
 public String fileTitle = null;
 public int maxFileTitle = 0;
 public String initialDir = null;
 public String title = null;
 public int flags = 0;
 public short fileOffset = 0;
 public short fileExtension = 0;
 public String defExt = null;
 public IntPtr custData = IntPtr.Zero;
 public IntPtr hook = IntPtr.Zero;
 public String templateName = null;
 public IntPtr reservedPtr = IntPtr.Zero;
 public int reservedInt = 0;
 public int flagsEx = 0;
}

public class FilePicker : MonoBehaviour
{
    private OpenFileName openFileName;

    [DllImport("Comdlg32.dll", SetLastError = true, CharSet = CharSet.Auto)]
    private static extern bool GetOpenFileName([In, Out] OpenFileName ofn);

    public void ChooseVideo() // 将方法名从ChooseImage改为ChooseVideo，并调整注释
    {
        InitializeOpenFileName("mp4"); // 初始化时使用"mp4"作为默认视频类型，可根据需求添加更多类型

        if (GetOpenFileName(openFileName))
        {
            string selectedFilePath = openFileName.file.TrimEnd('\0');
            // 在这里处理用户选择的视频文件路径
            Debug.Log("选定的视频文件路径: " + selectedFilePath);
        }
    }

    private void InitializeOpenFileName(string type)
    {
        openFileName = new OpenFileName();
        openFileName.structSize = Marshal.SizeOf(openFileName);
        
        // 更新过滤器以包含视频文件类型
        openFileName.filter = "视频文件(*." + type + ")\0*." + type + ";*.avi;*.mov;*.wmv;*.mkv;*.mpg;*.mpeg;*.flv\0所有视频文件 (*.*)\0*.*\0";
        
        openFileName.file = new string(new char[256]);
        openFileName.maxFile = openFileName.file.Length;
        openFileName.fileTitle = new string(new char[64]);
        openFileName.maxFileTitle = openFileName.fileTitle.Length;
        openFileName.initialDir = Application.dataPath; // 默认路径设置为项目的Assets目录，但注意这在实际应用中可能不适合选择本地文件
        openFileName.title = "选择视频文件";
        openFileName.flags = 0x00080000 | 0x00001000 | 0x00000800 | 0x00000008; // 保留原标志位设置
    }
}