如何在C++/WinRT组件中暴露float3类型属性给C#应用？

问题背景 #

我正在编写一个供C#应用调用的自定义C++/WinRT组件，需要向调用方暴露带有Id（整数类型）和Position（float3类型）属性的MyObject对象。原.idl和头文件代码如下：

原.idl代码

runtimeclass MyObject
{
    MyObject();
    Int32 Id();
    Windows::Foundation::Numerics::float3 Position();
}

原.h代码

#pragma once
#include "MyObject.g.h"

namespace winrt::TestComponent::implementation 
{
    struct MyObject : MyObjectT<MyObject>
    {
        MyObject();
        int32_t Id();
        Windows::Foundation::Numerics::float3 Position();

    private:
        int _id;
        Windows::Foundation::Numerics::float3 _position;
    };
}

namespace winrt::TestComponent::factory_implementation
{ 
    struct MyObject : MyObjectT<MyObject, implementation::MyObject>
    {
    };
}

编译时在声明Position()的行报错：[msg]syntax error [context]: expecting an identifier near ":"，原因是WinRT IDL不原生支持Windows::Foundation::Numerics::float3类型——该类型是C++端的具体实现类型，无法直接在跨语言的IDL中声明。

最佳解决方案：使用WinRT原生支持的Vector3类型 #

WinRT提供了跨语言兼容的数值类型Windows.Foundation.Numerics.Vector3，它和C++端的float3可以无缝转换，同时C#端会自动映射为System.Numerics.Vector3，完美满足跨语言调用需求。

步骤1：修改IDL文件

导入windows.foundation.numerics.idl，并将属性类型替换为Vector3，同时使用WinRT标准的属性getter语法：

import "windows.foundation.numerics.idl";

runtimeclass MyObject
{
    MyObject();
    Int32 Id{ get; };
    Windows.Foundation.Numerics.Vector3 Position{ get; };
}

步骤2：修改C++头文件

调整返回类型为winrt::Windows::Foundation::Numerics::Vector3，同时确保包含对应的头文件：

#pragma once
#include "MyObject.g.h"
#include <winrt/Windows.Foundation.Numerics.h>

namespace winrt::TestComponent::implementation 
{
    struct MyObject : MyObjectT<MyObject>
    {
        MyObject();
        int32_t Id() const;
        winrt::Windows::Foundation::Numerics::Vector3 Position() const;

    private:
        int32_t _id;
        winrt::Windows::Foundation::Numerics::float3 _position;
    };
}

namespace winrt::TestComponent::factory_implementation
{ 
    struct MyObject : MyObjectT<MyObject, implementation::MyObject>
    {
    };
}

步骤3：实现属性逻辑

在.cpp文件中，C++/WinRT会自动处理float3到Vector3的转换，无需额外代码：

#include "pch.h"
#include "MyObject.h"

namespace winrt::TestComponent::implementation
{
    MyObject::MyObject() : _id(0), _position{0.f, 0.f, 0.f}
    {
    }

    int32_t MyObject::Id() const
    {
        return _id;
    }

    winrt::Windows::Foundation::Numerics::Vector3 MyObject::Position() const
    {
        // 自动完成float3到Vector3的转换
        return _position;
    }
}

为什么这是最佳方案 #

• 跨语言兼容性：Vector3是WinRT官方定义的跨语言数值类型，C#、JavaScript等语言都有对应的原生类型映射，无需手动序列化/反序列化。
• 零转换成本：C++/WinRT框架已经内置了float3和Vector3的双向转换逻辑，代码简洁高效。
• 符合WinRT设计规范：遵循WinRT的类型系统规则，避免自定义类型带来的兼容性和维护问题。

内容的提问来源于stack exchange，提问作者nooway764