3D 模型交互状态通知与实时坐标获取方法

编辑器 2026.2 版本完成功能更新，官方提供 3D 模型场景专属开发接口，支持开发者接收 3D 模型进出状态通知、实时接收 3D 坐标位置数据，可广泛应用于 3D 模型加载 / 退出监控、3D 位置数据实时监听等核心业务开发场景。

核心功能接口说明

3D 模型状态通知专用接口

以下两个接口用于实现 3D 模型进入、退出时的消息通知接收功能：

FRAppRegist3DModelHandler
FRAppUnRegister3dProvider

3D 坐标位置获取专用接口

以下两个接口用于实现 3D 模型进入、退出时的 3D 坐标位置数据接收功能：

FRAppRegistJSReceive3DPosition
FRAppUnRegistJSReceive3DPosition

3D 坐标位置获取示例代码

FR_3DProviderCallbacksRec m_3DProviderCallback;
memset(&m_3DProviderCallback, 0, sizeof(FR_3DProviderCallbacksRec));
m_3DProviderCallback.lStructSize = sizeof(FR_3DProviderCallbacksRec);
m_3DProviderCallback.FR3DActivate = On3DActivate;
m_3DProviderCallback.FR3DDeActivate = On3DDeActivate;

FS_LPVOID pHandler = FRAppRegist3DModelHandler(&m_3DProviderCallback);


void On3DActivate(FS_LPVOID clientData, FR_Annot p3DAnnot){
FS_WideString wsError = FSWideStringNew();
 
FR_Document frDocument = FRAppGetActiveDocOfPDDoc();
FS_ByteString annotType = FSByteStringNew();
FRAnnotGetType(p3DAnnot, &annotType);
FS_LPCSTR subType = FSByteStringCastToLPCSTR(annotType);
 
FRAppRegistJSReceive3DPosition(OnJSReceive3Dposition, p3DAnnot, &wsError);
FS_LPCWSTR wszError = FSWideStringCastToLPCWSTR(wsError);
if (!FSWideStringIsEmpty(wsError)){ AfxMessageBox(L"JSReceive3DPosition registered failed."); }

else{ AfxMessageBox(L"JSReceive3DPosition registered successfully."); }

FSWideStringDestroy(wsError);
}
 
void On3DDeActivate(FS_LPVOID clientData, FR_Annot p3dAnnot){ FRAppUnRegistJSReceive3DPosition(p3dAnnot); 
}
 
void OnJSReceive3Dposition(double x, double y, double z)
{
 std::string message = "Received 3D position: x = " + std::to_string(x) + ", y = " + std::to_string(y) + ", z = " +  OutputDebugStringA(message.c_str()); OutputDebugStringA("\r\n"); 
}

核心功能接口说明

3D 模型状态通知专用接口

3D 坐标位置获取专用接口

3D 坐标位置获取示例代码

PDF后台批量处理：如何将文档保存为线性化格式（福昕SDK教程）

【合同/协议必备】PDF一键盖骑缝章，防换页防篡改！

在执行文件打印时如何将默认的打印数量设置为1

PDF字体嵌入教程：如何将文档中使用到的所有字体完全嵌入

福昕2026版新增PDF转CAD，DWG/DXF一键搞定！

在合并文件时如何统一设置页面大小

文件每次打开时缩放比例都是200%如何将缩放比例调整为100%

如何查看查看PDF/A的版本信息

如何使用电子签章对内签署

电子签章签署后如何查看相关签署记录