【官方】Ulanzi Studio插件开发指南---如何开发插件

Ulanzi

Ulanzi Studio 插件开发指南

一、介绍
在本文中，您将学习如何设置开发环境、创建您的第一个Ulanzi Studio插件，以及在Ulanzi Studio中测试您的插件及上架到Marketplace。

先决条件
使用Ulanzi Studio SDK开发插件需要完成以下准备：
1、Ulanzi Deck设备：任意型号（如Ulanzi Deck、Ulanzi Deck Dock等）。
2、Ulanzi Studio软件：已安装，建议最新版。
3、Node.js版本：已安装， 版本要求20或更高版本。



二、插件开发指南
详细的开发教程可以参考如下链接：
Html插件指南
NodeJS插件指南

SDK 地址
SDK地址：https://github.com/UlanziTechnology/UlanziDeckPlugin-SDK/

示例
https://github.com/UlanziTechnology/UlanziDeckPlugin-SDK/tree/main/demo


三、其它注意事项：

• 提交指南
• 社区准则
• 插件元数据、图标、布局介绍
• 缩略图、应用程序图标的介绍
  

红桃K

插件开发完成后，如何将开发的插件本地加载使用，请提供一下方法，谢谢 。

Ulanzi

你好，开发插件后，加载本地插件的方法见下方链接：

https://bbs.ulanzistudio.com/thread-64-1-1.html

someone404

html和node两种插件有什么区别，分别适合什么场景？

huanghy

someone404 发表于 2025-9-30 04:12
html和node两种插件有什么区别，分别适合什么场景？

应该就是两种实现方式，那种方式适合实现插件功能，就用哪种实现方法。使用上面没有什么区别

aqsz200

请问如何调试？
比如如何查看各种插件的log和异常信息？

chxdon

aqsz200 发表于 2025-10-13 11:37
请问如何调试？
比如如何查看各种插件的log和异常信息？

html类型的插件，可以在程序启动时附加 [size=0.9em]--webEngineArgs --remote-debugging-port=<portnumber> 参数，例如9222，就可以在localhost:9222 页面上调试插件了，这是Qt程序自带的远程调试命令

iBobby

chxdon 发表于 2025-10-28 16:31
html类型的插件，可以在程序启动时附加 --webEngineArgs --remote-debugging-port= 参数，例如9222，就可 ...

macOS好像无法调试

bada

iBobby 发表于 2025-11-15 14:04
macOS好像无法调试

터미널에서 아래의 명령어를 실행하세요.

1. QTWEBENGINE_REMOTE_DEBUGGING=9222 /Applications/Ulanzi\ Studio.app/Contents/MacOS/UlanziDeck

复制代码