FaceInstance

FaceInstance.Face

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.


Instance.AncestryChanged

child

parent

Instance.AttributeChanged

attribute

This snippet prints the names of objects as they are added to the Workspace:


Instance.ChildAdded

This snippet prints the names of objects as they are removed from the
Workspace:


Instance.ChildRemoved

This following example will print the name of any object that is added to the
Workspace:


Instance.DescendantAdded

descendant

The following example prints the name of any descendant as it is being removed
from the Workspace:


Instance.DescendantRemoving

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.


This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.


Instance.Destroying

Instance.childAdded

Instance:AddTag

This example creates a Part and adds a few sparkle objects to the part. Then
it calls Part:ClearAllChildren() to remove all of the children.


Instance:ClearAllChildren

Demonstrates cloning a model using `Class.Instance:Clone()`.

Instance:Clone

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.


Instance:Destroy

Instance:FindFirstAncestor

name

Instance:FindFirstAncestorOfClass

className

Instance:FindFirstAncestorWhichIsA

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".


Instance:FindFirstChild

recursive

Instance:FindFirstChildOfClass

Instance:FindFirstChildWhichIsA

Instance:FindFirstDescendant

Instance:GetActor

Instance:GetAttribute

Instance:GetAttributeChangedSignal

Instance:GetAttributes

The below would print the name of all objects currently in Workspace when ran.


Instance:GetChildren

Instance:GetDebugId

scopeLength

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.


Instance:GetDescendants

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.


This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.


Instance:GetFullName

Instance:GetStyled

Instance:GetTags

Instance:HasTag

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.


Instance:IsAncestorOf

Instance:IsDescendantOf

ancestor

The following code demonstrates how a part can be re-added to the DataModel
after being removed:


Instance:Remove

Instance:RemoveTag

Instance:SetAttribute

value

The following code waits for an instance named "Part" to be added to
Workspace.


Instance:WaitForChild

childName

timeOut

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Instance.Archivable

Instance.Capabilities

Instance.Name

Instance.Parent

Instance.RobloxLocked

Instance.Sandboxed

Instance.UniqueId

Instance.archivable

This sample demonstrates the subtleties of the Changed event on normal objects
and "-Value" objects.


This code sample demonstrates the Changed event firing within a parent object.


Object.Changed

property

This code sample demonstrates how to save a value before a changed event fires
on it in order to get more information about a change.


This code sample demonstrates the equivalence of the `Changed` event and event
returned by `GetPropertyChangedSignal`.


Object:GetPropertyChangedSignal

Demonstrates determining the class of Workspace using `Class.Instance:IsA()`

Workspace is of class 'Workspace', so the first statement is true.
Workspace is not of class 'BasePart', so the second statement is false.
Workspace inherits from Instance and therefore is of class 'Instance', so the third statement is true.


Object:IsA

Object:isA

Object

Object.ClassName

Object.className

/reference/engine/classes/FaceInstance.yaml

FaceInstance 是一个抽象类，从它的 `Class.Decal` 类继承。

Class.Actor 是一个可以安全分离为其自己线程的代码容器。

Class

Actor

Luau

Array

Dictionary

Data Type

NormalId 列表设置哪个零件的哪个面/侧面。

Enum

Enum.NormalId

RBXScriptSignal

Variant

bool

number

字母、数字和符号等的字符串。

string

void

概览

指南

教程

参考

资源

艺术

设计

引擎

虚拟形象

旧版本

云端

This method is asynchronous and returns an `Operation`, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the [documentation]({longRunningOperationsLink}) on long-running operations for more information.
            
The following sections describe the response and metadata objects that are provided when an operation completes.

Beta 测试终点已准备好公开使用。可能出现导致功能无法正常运作的更改，但几率极低。

此字段可能在创建资源时被设置，但可能无法在后续请求中修改。

此字段可以在请求中提供，但永远不会包括在答复中。

每个 API 密钥：每个 IP 地址每 {periodInSeconds} 秒有 {maxInPeriod} 次请求

此字段可能被设置为响应，但在请求中将被忽略。

调用此端点需要以下 API 密钥权限。关于生成正确密钥的更多信息，请查看 【管理 API 密钥】({apiKeyReferenceDocLink})。

相对于基础 URL 的路径，下列端点是可用的。

此字符串格式为 [FieldMask](/cloud/reference/types#fieldmask)。

JSON 值可以是 “null”、“boolean”、“string”、“number”、“array” 或 “object”。

若要使用此端点，你的 OAuth 2.0 应用程序需要以下范围。关于如何注册 OAuth 2.0 应用程序的更多信息，请查看【应用程序注册及评价】({oauth2ReferenceDocLink})。

下列对象描述了接受或返回的有效载荷。请参阅每个单独的端点，以了解更多关于这些对象用途的信息。

这将允许查看关于你素材的信息。

这将允许在 Roblox 上传或更新素材。

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows you to manage group join requests for your account.

这将允许查看你的道具栏信息。

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow experiences on your behalf.

Grants permission to read group information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

授予代替用户发布信息的权力。

This allows sending notifications from your experience to users.

这将允许列出与你的作品相关联的密钥。

这将允许创作和更新与你的作品相关联的密钥。

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

此操作将会允许发布作品的新版本至 Roblox。

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

默认值：{defaultValueStart}{defaultValueEnd}

数组是一个有序的数值列表。数组有助于存储数据集。

一组键值对，键值可以是任意数字、字符串或对象。

正如{tuples}一样，是一系列的值。

此函数将在可能是立即返回，但在返回值之前可以暂停调用自己的线程。

Roblox 已不再支持或维护{nameStart}名称{nameEnd}。

Roblox 已不再支持或维护这项数学运算。

此成员未在对象浏览器中出现，不应广泛使用。

此成员只能通过命令行访问。从脚本尝试访问此成员将导致错误。

此函数无法暂停调用自己的 Lua 线程。

从脚本尝试访问此成员将导致错误。你可能可以从 Roblox Studio 的属性窗口访问。

此成员不在 Roblox Studio 的对象浏览器中。

你无法使用 Instance.new 构造器创建此类别的实例。

Roblox 不会在跨服务器与客户机界限而复制此成员。

Lua 编程码无法访问此成员。你可能可以从 Roblox Studio 的属性窗口更改其值。

此会员可以从 OpenCloud Luau 执行任务访问。

此对象的复制行为取决于拥有它的玩家。

此成员可以通过命令行和插件访问。从脚本尝试访问此成员将导致错误。

此成员为只读。尝试写入此成员将会导致错误。

此属性为只读，可以从未同步的线程读取。尝试写入可能会导致错误。

只有 Roblox CoreScript 可以访问此成员，Players 不可用。

你可以安全地从多线程对此属性进行读写。

此类别为顶级类单例。使用 GetService 函数获取此类别的实例。

多线程可以写入此属性，所以从未同步的线程读取将会有风险。

此函数在返回借过前将会暂停调用自己的的线程。此操作不会中断其他脚本。

借助丰富的指南、代码示例、参考和教程，学习如何在 Roblox 上创作出优秀内容。

{pageTitle} | {SiteName}

2D 路径

3D 艺术概览

3D 拖动侦测器

3D 导入器

3D 工作区

9-Slice

9 宫格设计

AI 数据共享

API 密钥

关于 GDPR 和 CCPA

无障碍准则

访问本地化设置

配饰适配工具

帐户信息

帐户设置

帐户验证

获取

活动历史记录

活动课程

广告配置

自适应时间间隔

添加新模型

添加动画

新增回合

添加脚本

添加翅膀

添加第二个造型

添加至车库

广告管理工具

高级

冒险游戏计划

冒险游戏第 1 部分

冒险游戏第 2 部分

冒险游戏第 3 部分

在 Roblox 上开展广告推广

对齐方向

对齐位置

对齐工具

全部云端 API

所有项目

分析

分析面板

分析数据基础

角速度

在 Roblox 中实现动画

将角色动画化

将头部动画化

动画化部件

动画

动画捕捉

动画编辑器

动画事件

动画和反馈

外观

外观修改器

应用抛光素材

应用表面图像

建筑

骨架设置

组装素材库

组件

组装模块化环境

素材传递 v1

素材传递 v2

素材管理器

素材隐私

素材

助手

文档助手

氛围

受众

观众参与

音频

音频素材

验证 v1

验证 v2

验证 v3

自动缩放

自动蒙皮

自动翻译

虚拟形象环境菜单

虚拟形象创建

虚拟形象编辑器

虚拟形象检查菜单

虚拟形象道具

虚拟形象预览

虚拟形象设置

虚拟形象标签页

虚拟形象教程

虚拟形象 v1

虚拟形象 v2

虚拟形象 v3

返回虚拟形象教程

返回向导

返回教程

徽章

平衡虚拟经济

BallSocket

基本游戏玩法

基本粒子效果

生存游戏

生存战项目

光束

成为艺术家

新手内容

成为数字公民

最佳实践

Beta 版功能

对体验进行 Beta 测试

超越黑暗

可绑定

Blender 配置

Blender 设置

Blender 和 Maya 导出设置

身体

身体 - 来自模版

身体比例

布尔

盒子模型

品牌开发者目录

泡泡聊天

“打造，游玩”系列

建造一半

建造摩天轮

建造铰链门

打造 Studio 部件

建造系统

建造独特 3D 对象

创建你的企业

建筑物和道具

建造公路

内置

按钮

购买升级

CFrames

笼式架构

笼式架构角色头部

笼式架构设置

健美操工具

摄像头

目录 v1

目录 v2

挑战关口 1

挑战关口 2

挑战关口 3

更改动画

更改脚本

角色控制工具

角色

聊天

语音聊天

选择艺术样式

类 (Classes)

经典服装

课堂最佳范例

教室便利设施

清理

清理并重置

客户端-服务器运行时间

客户端设置 v1

客户端设置 v2

服装

云服务

抽象编程

编写算法

编程基础

编写一个函数

编写一个问题

编写游戏循环代码

编写排行榜代码

为故事编写代码

协作

协作最佳范例

收集道具

碰撞

颜色和纹理

合并头部几何体

社区

社区反馈计划

完成城市

完成挑战

遵守广告标准

条件

连接光束

控制台准则

构建你的世界

建造房屋

联系人

容器

内容更新

基于情景的购买

控制结构

控制用户的摄像头

转换为配饰

核心

核心课程

核心循环

核心脚本

创建基本视觉效果

创建玩家障碍

创作你的第一个体验

创建硬币采集机制

创建项目

使用地形创建环境

创建并摧毁

创建第一个造型

从现有模型创建配饰

创建动画

创建基本头部

创建套装安装器

创建角色动画

创建电梯

创造吸引人的体验

创建爆炸

创建面部配饰

创建闪烁光线

创建生命值拾取

创建交互按钮

创建激光光束

创建移动对象

创建霓虹灯标志

创建部件界面

创建玩家工具

创建私人服务器

创建临近提示

创建得分栏

创建缝线并展开

创建旋转对象

创建团队

创建火山

创建瀑布

创建图形用户界面 (GUI)

创建剧本

创建烟花棒

创建纹理地图

创建和发布

创建地图

使用模块脚本创建

创作概览

创作者合作伙伴试营项目

创作者活动

创作者基金

创建者热点

创作者商店

跨平台设计

跨服务器信息

当前发布

曲线编辑器

自定义

自定义活动

自定义区域 

自定义粒子效果

自定义缩略图

自定义翻译

自定义全局光线

自定义和分享

自定义体验内文本聊天

圆柱

DMAC 指南

主控页面

数据模型

数据存储

数据结构

数据类型

致命熔岩

错误调试

深度链接

设计黑暗音景

设计教育体验

为 Roblox 设计

设计造型

设计你的飞船

设计地图

性能设计

设计世界

检测击中数

检测用户输入

开发抛光素材

开发者奖

开发者控制台

开发者产品

发展移动世界

开发 v1

开发 v2

字典和矩阵

数字公民身份

禁用默认界面

禁用默认界面元素

探索

拖动侦测器

复制和设计

动态效果

在 Roblox 上赚取收益

经济

经济创作者统计

经济活动

教育者入门

效果

Else/If 练习 - 给予点数

嵌入和导出纹理

表情栏

表情动作

结束比赛

互动

参与度收益

引擎 API 参考

引擎实例

增强室内环境

增强户外环境

用未来照明改善室外环境

枚举

环境

环境艺术

错误代码和限制

错误报告

错误

活动组织者

事件序列器

活动类型

活动

活动平台

体验活动

体验准则

体验图标

体验通知

体验缩略图

熟练内容

体验

浏览器窗口

导出设置

导出

导出动画

从 Maya 导出动画

导出角色模型

导出 FBX

从 Blender 导出 FBX

从 Blender 导出

外部目录查询

外部工具

额外头部对象

FACS 姿势参考

渐渐消失的陷阱

精选内容

功能

最终检查

完成项目

完成并添加更多

完成冲击波

适配和转换

关注 v1

关注 v2

基础游戏玩法系统

常见问题

好友邀请奖励系统

好友

好友定位器

函数

功能与活动

漏斗活动

银河赛道

游戏资金

游戏国际化 v1

游戏国际化 v2

游戏加入

游戏设置

手柄

游戏玩法脚本

游戏 v1

游戏 v2

离开地面

开始

被 Roblox 自有频道列为精选

开始入门

开发者入门

全局光照

全局风力

全局变量

使用 For 循环的发光光线

超越挑战

参加比赛

前往教育者入门

对你的环境进行灰盒测试

对一个可玩区域进行灰盒测试

网格和表格

分组部件

群组

群组 v1

群组 v2

增加受众

准则

处理请求

哈希图

头部

高亮

铰链

使用激光击中检测

首页标签页

图标和缩略图

查明问题

If/Then 练习 - 强化

If/Then 练习 - 陷阱

沉浸式广告

身临其境的叙事

在 Studio 提升设计

改善

改善冲击波行为

提升玩家数据和购买系统

导入 PBR 纹理

导入至 Studio

提升性能

在 Blender 中

体验内素材创建

体验内工具

体验内界面

体验内界面容器

游戏内声音

在 Studio 中

输入

输入与摄像头

激励

安装和设置

实例

实例属性

示例流

知识产权

交互按钮

部件上的界面

中级游戏玩法

脚本入门

阵型介绍

字典入门

数字文明入门

数字安全入门

循环入门

游戏设计和编程入门

if 声明入门

模块脚本入门

Roblox 入门

物品栏

道具栏 v1

道具栏 v2

逆向运动学

邀请好友

邀请好友游玩

岛屿地形

移动之岛

道具配置

语言代码

带光束的激光陷阱

层叠服饰

布局结构

布局和外观

布局和设计

排行榜

学习和探索排序

旧版聊天系统

光线来源

照明

使用道具照明

光线和抛光

线力

线性速度

列表和弹性布局

Roblox 教育者列表

LiveOps 基础知识

LiveOps 规划

加载屏幕

地区

本地化

本地化表格

使用脚本进行本地化

循环动画

在阵型中循环

循环

Luau 参考

主要设计要求

完成最后润色

对阵型进行更改

使用网格密封

制造爆炸

管理品牌整合

管理

管理数据存储

管理玩家

奇幻豪宅

手动编辑本地化表格

市场营销材料

商城费用和佣金

商城概览

商城政策

材质生成器

将世界物化

材质

机械限制条件

记忆存储

记忆内存

商品展位

网格

发送消息

元表

指标

微型性能剖析器

迁移至体验内文本聊天

迷你地图系统

移动端

模型标签页

建模

建模规范

模型

审核

模式

修改外部笼式架构

收益化

收益化基础

监控

监测性能

情绪

鼠标和键盘

移动约束

移动身体

多线程

多条件 Else/If

多重参数和变量

NPC 套装

名称和健康显示

本地代码生成

嵌套循环

网络所有权

下一步进展

NoCollision

提名探索页面

知名译者项目

通知

数字

OAuth 2.0

对象属性

对象

可观测性

屏幕界面

屏幕界面容器

入门

入门技术

打开模板

运算符

优化你的体验

有序数据存储

整理代码

输出窗口

PBR 材料参考

PBR 纹理（可选）

页面布局

付费通行证

Pairs 和 iPairs

参数联系 - 按钮

父代和子代

粒子发射器

部件

通行证

路径查找

图案

分区限制

性能

性能优化

照片展位

基于物理的渲染 (PBR)

物理

拾取系统

枢轴工具

场景发布

平面

规划教育设置

植物参考项目

平台概览

玩家邀请提示

玩家推荐系统

玩家界面

玩家

播放背景音乐

播放角色动画

播放位置音效

在 Roblox 上游玩

对地图进行测试

插件标签页

政策和准则

定位和缩放

后期处理效果

Premium 功能

存在

价格优化

棱柱

私信

私人服务器

产品

个人资料卡

项目清理

项目设置

项目

宣传

提示指南和示例

属性窗口

属性和特性

原型

感应提示

发布

发布眉毛和睫毛

发布至商城

任务设计

队列

快速访问工具

R6-R15 适配器

随机虚拟物品政策

光线投射

实时

近期发布

录制和显示玩家数据

参考资源

参考文件

注册

624 发布说明

625 发布说明

626 发布说明

627 发布说明

628 发布说明

629 发布说明

630 发布说明

631 发布说明

632 发布说明

远程

移除多余骨骼

使用 while 循环重复代码

留存

从表中返回值

重新使用代码

丰富文本标记

骨架建造器

骨架

索具类人模型

索具一个简单的网格

绑定类人模型

在 Blender 中绑定人形模型

在 Blender 中绑定简单网格

索具并围笼一个现有模型

构造骨架和蒙皮

版权管理工具

清除请求的权利

变形

绑定配饰

Roblox Blender 插件

Roblox Connect 项目

Roblox 开发者第一课

Roblox 开发者大会(RDC)

Roblox 创新奖

Roblox 研究小组

Roblox Studio

Roblox Studio 基础

Roblox 单位

Roblox 用户群

针对 AP CSP 的 Roblox

Roblox：针对 Unity 的开发者

Roblox：针对 Unreal 开发者

绳索

运行课堂

运行游戏

示例应用

保存并发布

通过发布来保存

保存数据

寻宝行动

调度程序

范围

得分点

脚本能力

脚本编辑器

脚本性能分析器

脚本标签页

编写一个升级按钮的脚本

脚本

脚本化虚拟形象动画

雕刻

雕塑细节

雕塑地形

搜索广告

设计赛季通行证

安全策略与作弊防范

自拍模式

出售道具

在创作者商店中发售

出售你的配饰

服务

设置网格

设置 Studio

设置一个 Roblox 课堂

设置团队

分享你的飞船

尺寸修改工具和约束

蒙皮类人模型

蒙皮一个简单的网格

在 Blender 中蒙皮人形模型

在 Blender 中蒙皮简单网格

Skyboxes

睡眠系统

对齐至栅格

社交

实体建模

排序地图

音效

音效设计

空间数据

空间语音

与好友一起生成

生成点和重生点

规格

赞助体验

赞助项目

弹簧

堆叠

标准数据库

开始编程

故事游戏

沉浸式直播

字符串

Studio

Studio 界面

Studio 设置

Studio 快捷方式

Studio 测试模式

设计订阅

辅助系统

表面艺术

标签参考

标签表

开始起飞

人才中心开发者安全性

任务计划程序

远程教学

团队

技术概览

技术规格

传送

模板文件

模版

地形

地形编辑器

地形工具

测试标签

测试与游玩

测试并保存

测试

测试角色

测试造型

测试游戏

测试飞船

文字聊天

文本过滤

文本输入

文本输入字段

纹理生成器

纹理绘画

纹理绘画设置

纹理规范

纹理和贴花

纹理

纹理化眼睛

纹理化面部

神秘的杜瓦尔大道

风暴

第三方分析服务

第三方软件

缩略图

缩略图调整工具

定时桥接循环

计时器和活动

小贴士和设置

首页的今日精选

商城的今日精选

工具箱

工具

扭矩

TorsionSpring

交易

踪迹效果

翻译动态内容

翻译体验页面信息

翻译体验内容

翻译角色

修建衣服形状

元组

两步验证

类型检查

强制类型转换

类型

类型和位置

界面动画

UI 动画/Tween

界面拖动侦测器

UI 对象

UI 和 UX

单元课程

通用

上传和发布

上传你的素材

用户广告

用户界面

用户界面设计

用户库存

用户数据

用户

使用动画

在 Studio 中使用头部

使用带有参数的信息

使用微型性能剖析器

使用粒子进行动作

使用粒子制造爆炸

使用 Studio 的 3D 导入器

使用纹理

使用配饰适配工具

视觉效果

VR 准则

认证工具

变量

变量和对象

矢量

验证附件

视频素材

视频帧

查看标签页

逐步说明

武器套装

Webhook 通知

接合

针对你的配置绘制线框图

与译者合作

在团队中工作

编写故事

Xbox 准则

FaceInstance

概要

属性

方法

活动

属性

Face

方法

活动