41 lines
1.1 KiB
Markdown
41 lines
1.1 KiB
Markdown
# ScriptEngine::TrySetScriptFieldValue
|
|
|
|
**命名空间**: `XCEngine::Scripting`
|
|
|
|
**类型**: `method`
|
|
|
|
**头文件**: `XCEngine/Scripting/ScriptEngine.h`
|
|
|
|
## 签名
|
|
|
|
```cpp
|
|
bool TrySetScriptFieldValue(
|
|
ScriptComponent* component,
|
|
const std::string& fieldName,
|
|
ScriptFieldType type,
|
|
const ScriptFieldValue& value);
|
|
```
|
|
|
|
## 当前实现流程
|
|
|
|
1. 先拒绝空组件、空字段名或类型/值不兼容的请求。
|
|
2. 如果组件已绑定脚本类，并且运行时能返回类字段元数据：
|
|
- 字段必须存在。
|
|
- 字段类型必须完全匹配。
|
|
3. 如果当前运行时正在运行，且组件已有实例：
|
|
- 先尝试写托管字段。
|
|
- 托管写失败则整体失败。
|
|
4. 托管写通过后，再写入 `ScriptFieldStorage`。
|
|
|
|
## 设计意义
|
|
|
|
当前实现坚持“先过元数据校验，再写活实例，最后更新本地缓存”这条顺序。这样可以避免：
|
|
|
|
- 向不存在的托管字段写脏数据。
|
|
- 运行时值与本地缓存不一致。
|
|
|
|
## 相关文档
|
|
|
|
- [TryGetScriptFieldValue](TryGetScriptFieldValue.md)
|
|
- [TryGetScriptFieldModel](TryGetScriptFieldModel.md)
|