LocalizationService 是負責處理自動翻譯的服務。

它用作存儲 `Class.LocalizationTable` 對象，這些對象用於自動文本替換。

LocalizationService 只會使用其子 LocalizationTables 進行自動文本替換，除非在 GUI 物件或其祖先上指定了 `Class.GuiBase2d.RootLocalizationTable`。


返回用於本地化核心腳本的 `Class.LocalizationTable` 對象列表。


LocalizationService:GetCorescriptLocalizations

此代碼範例獲取本地玩家的國家/地區代碼並打印

"你好，來自加拿大的朋友！" 如果玩家的客戶端 IP 地理位置是加拿大。

根據玩家的客戶端 IP 地理位置返回國家/地區代碼字符串。所支持的國家/地區代碼如下：

<table>
  <thead>
    <tr>
      <th>代碼</th>
      <th>國家/地區</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>US</td><td>美國</td>
    </tr>
    <tr>
      <td>GB</td><td>英國</td>
    </tr>
    <tr>
      <td>CA</td><td>加拿大</td>
    </tr>
    <tr>
      <td>AF</td><td>阿富汗</td>
    </tr>
    <tr>
      <td>AX</td><td>奧蘭群島</td>
    </tr>
    <tr>
      <td>AL</td><td>阿爾巴尼亞</td>
    </tr>
    <tr>
      <td>DZ</td><td>阿爾及利亞</td>
    </tr>
    <tr>
      <td>AS</td><td>美屬薩摩亞</td>
    </tr>
    <tr>
      <td>AD</td><td>安道爾</td>
    </tr>
    <tr>
      <td>AO</td><td>安哥拉</td>
    </tr>
    <tr>
      <td>AI</td><td>安圭拉</td>
    </tr>
    <tr>
      <td>AQ</td><td>南極洲</td>
    </tr>
    <tr>
      <td>AG</td><td>安提瓜和巴爾布達</td>
    </tr>
    <tr>
      <td>AR</td><td>阿根廷</td>
    </tr>
    <tr>
      <td>AM</td><td>亞美尼亞</td>
    </tr>
    <tr>
      <td>AW</td><td>阿魯巴</td>
    </tr>
    <tr>
      <td>AU</td><td>澳大利亞</td>
    </tr>
    <tr>
      <td>AT</td><td>奧地利</td>
    </tr>
    <tr>
      <td>AZ</td><td>阿塞拜疆</td>
    </tr>
    <tr>
      <td>BS</td><td>巴哈馬</td>
    </tr>
    <tr>
      <td>BH</td><td>巴林</td>
    </tr>
    <tr>
      <td>BD</td><td>孟加拉國</td>
    </tr>
    <tr>
      <td>BB</td><td>巴巴多斯</td>
    </tr>
    <tr>
      <td>BY</td><td>白俄羅斯</td>
    </tr>
    <tr>
      <td>BE</td><td>比利時</td>
    </tr>
    <tr>
      <td>BZ</td><td>貝爾哈國</td>
    </tr>
    <tr>
      <td>BJ</td><td>貝南</td>
    </tr>
    <tr>
      <td>BM</td><td>百慕達</td>
    </tr>
    <tr>
      <td>BT</td><td>不丹</td>
    </tr>
    <tr>
      <td>BO</td><td>玻利維亞</td>
    </tr>
    <tr>
      <td>BQ</td><td>博內爾、聖尤斯特修斯和薩巴</td>
    </tr>
    <tr>
      <td>BA</td><td>波斯尼亞和赫塞哥維納</td>
    </tr>
    <tr>
      <td>BW</td><td>博茨瓦納</td>
    </tr>
    <tr>
      <td>BV</td><td>布維特島</td>
    </tr>
    <tr>
      <td>BR</td><td>巴西</td>
    </tr>
    <tr>
      <td>IO</td><td>英屬印度洋領地</td>
    </tr>
    <tr>
      <td>BN</td><td>汶萊達魯薩蘭</td>
    </tr>
    <tr>
      <td>BG</td><td>保加利亞</td>
    </tr>
    <tr>
      <td>BF</td><td>布基納法索</td>
    </tr>
    <tr>
      <td>BI</td><td>布隆迪</td>
    </tr>
    <tr>
      <td>KH</td><td>柬埔寨</td>
    </tr>
    <tr>
      <td>CM</td><td>喀麥隆</td>
    </tr>
    <tr>
      <td>CV</td><td>維德角</td>
    </tr>
    <tr>
      <td>KY</td><td>開曼群島</td>
    </tr>
    <tr>
      <td>CF</td><td>中非共和國</td>
    </tr>
    <tr>
      <td>TD</td><td>乍得</td>
    </tr>
    <tr>
      <td>CL</td><td>智利</td>
    </tr>
    <tr>
      <td>CN</td><td>中國</td>
    </tr>
    <tr>
      <td>CX</td><td>聖誕島</td>
    </tr>
    <tr>
      <td>CC</td><td>科科斯群島</td>
    </tr>
    <tr>
      <td>CO</td><td>哥倫比亞</td>
    </tr>
    <tr>
      <td>KM</td><td>科摩羅</td>
    </tr>
    <tr>
      <td>CG</td><td>剛果</td>
    </tr>
    <tr>
      <td>CD</td><td>剛果（南非民主共和國）</td>
    </tr>
    <tr>
      <td>CK</td><td>庫克群島</td>
    </tr>
    <tr>
      <td>CR</td><td>哥斯達黎加</td>
    </tr>
    <tr>
      <td>CI</td><td>科特迪瓦</td>
    </tr>
    <tr>
      <td>HR</td><td>克羅地亞</td>
    </tr>
    <tr>
      <td>CW</td><td>庫拉索</td>
    </tr>
    <tr>
      <td>CY</td><td>塞浦路斯</td>
    </tr>
    <tr>
      <td>CZ</td><td>捷克共和國</td>
    </tr>
    <tr>
      <td>DK</td><td>丹麥</td>
    </tr>
    <tr>
      <td>DJ</td><td>吉布提</td>
    </tr>
    <tr>
      <td>DM</td><td>多米尼克</td>
    </tr>
    <tr>
      <td>DO</td><td>多明尼加共和國</td>
    </tr>
    <tr>
      <td>EC</td><td>厄瓜多爾</td>
    </tr>
    <tr>
      <td>EG</td><td>埃及</td>
    </tr>
    <tr>
      <td>SV</td><td>薩爾瓦多</td>
    </tr>
    <tr>
      <td>GQ</td><td>赤道幾內亞</td>
    </tr>
    <tr>
      <td>ER</td><td>厄利垂亞</td>
    </tr>
    <tr>
      <td>EE</td><td>愛沙尼亞</td>
    </tr>
    <tr>
      <td>ET</td><td>埃塞俄比亞</td>
    </tr>
    <tr>
      <td>FK</td><td>福克蘭群島（馬爾維納斯）</td>
    </tr>
    <tr>
      <td>FO</td><td>法羅群島</td>
    </tr>
    <tr>
      <td>FJ</td><td>斐濟</td>
    </tr>
    <tr>
      <td>FI</td><td>芬蘭</td>
    </tr>
    <tr>
      <td>FR</td><td>法國</td>
    </tr>
    <tr>
      <td>GF</td><td>法屬圭亞那</td>
    </tr>
    <tr>
      <td>PF</td><td>法屬波利尼西亞</td>
    </tr>
    <tr>
      <td>TF</td><td>法屬南方領地</td>
    </tr>
    <tr>
      <td>GA</td><td>加蓬</td>
    </tr>
    <tr>
      <td>GM</td><td>甘比亞</td>
    </tr>
    <tr>
      <td>GE</td><td>喬治亞</td>
    </tr>
    <tr>
      <td>DE</td><td>德國</td>
    </tr>
  </tbody>
</table>

<table>
  <thead>
    <tr>
      <th>代碼</th>
      <th>國家/地區</th>
  </tr>
  </thead>
  <tbody>
    <tr>
      <td>GH</td><td>加納</td>
    </tr>
    <tr>
      <td>GI</td><td>直布羅陀</td>
    </tr>
    <tr>
      <td>GR</td><td>希臘</td>
    </tr>
    <tr>
      <td>GL</td><td>格陵蘭</td>
    </tr>
    <tr>
      <td>GD</td><td>格林納達</td>
    </tr>
    <tr>
      <td>GP</td><td>瓜德羅普</td>
    </tr>
    <tr>
      <td>GU</td><td>關島</td>
    </tr>
    <tr>
      <td>GT</td><td>危地馬拉</td>
    </tr>
    <tr>
      <td>GG</td><td>根西島</td>
    </tr>
    <tr>
      <td>GN</td><td>幾內亞</td>
    </tr>
    <tr>
      <td>GW</td><td>幾內亞比紹</td>
    </tr>
    <tr>
      <td>GY</td><td>圭亞那</td>
    </tr>
    <tr>
      <td>HT</td><td>海地</td>
    </tr>
    <tr>
      <td>HM</td><td>赫德島和麥克唐納群島</td>
    </tr>
    <tr>
      <td>VA</td><td>聖座</td>
    </tr>
    <tr>
      <td>HN</td><td>洪都拉斯</td>
    </tr>
    <tr>
      <td>HK</td><td>香港</td>
    </tr>
    <tr>
      <td>HU</td><td>匈牙利</td>
    </tr>
    <tr>
      <td>IS</td><td>冰島</td>
    </tr>
    <tr>
      <td>IN</td><td>印度</td>
    </tr>
    <tr>
      <td>ID</td><td>印尼</td>
    </tr>
    <tr>
      <td>IQ</td><td>伊拉克</td>
    </tr>
    <tr>
      <td>IE</td><td>愛爾蘭</td>
    </tr>
    <tr>
      <td>IM</td><td>曼島</td>
    </tr>
    <tr>
      <td>IL</td><td>以色列</td>
    </tr>
    <tr>
      <td>IT</td><td>義大利</td>
    </tr>
    <tr>
      <td>JM</td><td>牙買加</td>
    </tr>
    <tr>
      <td>JP</td><td>日本</td>
    </tr>
    <tr>
      <td>JE</td><td>澤西島</td>
    </tr>
    <tr>
      <td>JO</td><td>約旦</td>
    </tr>
    <tr>
      <td>KZ</td><td>哈薩克斯坦</td>
    </tr>
    <tr>
      <td>KE</td><td>肯尼亞</td>
    </tr>
    <tr>
      <td>KI</td><td>基里巴斯</td>
    </tr>
    <tr>
      <td>KR</td><td>韓國</td>
    </tr>
    <tr>
      <td>KW</td><td>科威特</td>
    </tr>
    <tr>
      <td>KG</td><td>吉爾吉斯斯坦</td>
    </tr>
    <tr>
      <td>LA</td><td>老撾</td>
    </tr>
    <tr>
      <td>LV</td><td>拉脫維亞</td>
    </tr>
    <tr>
      <td>LB</td><td>黎巴嫩</td>
    </tr>
    <tr>
      <td>LS</td><td>萊索托</td>
    </tr>
    <tr>
      <td>LR</td><td>利比里亞</td>
    </tr>
    <tr>
      <td>LY</td><td>利比亞</td>
    </tr>
    <tr>
      <td>LI</td><td>列支敦士登</td>
    </tr>
    <tr>
      <td>LT</td><td>立陶宛</td>
    </tr>
    <tr>
      <td>LU</td><td>盧森堡</td>
    </tr>
    <tr>
      <td>MO</td><td>澳門</td>
    </tr>
    <tr>
      <td>MK</td><td>馬其頓</td>
    </tr>
    <tr>
      <td>MG</td><td>馬達加斯加</td>
    </tr>
    <tr>
      <td>MW</td><td>馬拉維</td>
    </tr>
    <tr>
      <td>MY</td><td>馬來西亞</td>
    </tr>
    <tr>
      <td>MV</td><td>馬爾地夫</td>
    </tr>
    <tr>
      <td>ML</td><td>馬利</td>
    </tr>
    <tr>
      <td>MT</td><td>馬爾他</td>
    </tr>
    <tr>
      <td>MH</td><td>馬紹爾群島</td>
    </tr>
    <tr>
      <td>MQ</td><td>馬丁尼克</td>
    </tr>
    <tr>
      <td>MR</td><td>毛里塔尼亞</td>
    </tr>
    <tr>
      <td>MU</td><td>毛里求斯</td>
    </tr>
    <tr>
      <td>YT</td><td>馬約特</td>
    </tr>
    <tr>
      <td>MX</td><td>墨西哥</td>
    </tr>
    <tr>
      <td>FM</td><td>密克羅尼西亞</td>
    </tr>
    <tr>
      <td>MD</td><td>摩爾多瓦</td>
    </tr>
    <tr>
      <td>MC</td><td>摩納哥</td>
    </tr>
    <tr>
      <td>MN</td><td>蒙古</td>
    </tr>
    <tr>
      <td>ME</td><td>黑山</td>
    </tr>
    <tr>
      <td>MS</td><td>蒙特塞拉特</td>
    </tr>
    <tr>
      <td>MA</td><td>摩洛哥</td>
    </tr>
    <tr>
      <td>MZ</td><td>莫桑比克</td>
    </tr>
    <tr>
      <td>MM</td><td>緬甸</td>
    </tr>
    <tr>
      <td>NA</td><td>納米比亞</td>
    </tr>
    <tr>
      <td>NR</td><td>瑙魯</td>
    </tr>
    <tr>
      <td>NP</td><td>尼泊爾</td>
    </tr>
    <tr>
      <td>NL</td><td>荷蘭</td>
    </tr>
    <tr>
      <td>AN</td><td>荷蘭安地卡</td>
    </tr>
    <tr>
      <td>NC</td><td>新喀里多尼亞</td>
    </tr>
    <tr>
      <td>NZ</td><td>新西蘭</td>
    </tr>
    <tr>
      <td>NI</td><td>尼加拉瓜</td>
    </tr>
    <tr>
      <td>NE</td><td>尼日爾</td>
    </tr>
    <tr>
      <td>NG</td><td>尼日利亞</td>
    </tr>
    <tr>
      <td>NU</td><td>紐埃</td>
    </tr>
    <tr>
      <td>NF</td><td>諾福克島</td>
    </tr>
    <tr>
      <td>MP</td><td>北馬里亞納群島</td>
    </tr>
    <tr>
      <td>NO</td><td>挪威</td>
    </tr>
    <tr>
      <td>OM</td><td>阿曼</td>
    </tr>
  </tbody>
</table>

<table>
  <thead>
    <tr>
      <th>代碼</th>
      <th>國家/地區</th>
  </tr>
  </thead>
  <tbody>
    <tr>
      <td>PK</td><td>巴基斯坦</td>
    </tr>
    <tr>
      <td>PW</td><td>帛琉</td>
    </tr>
    <tr>
      <td>PS</td><td>巴勒斯坦</td>
    </tr>
    <tr>
      <td>PA</td><td>巴拿馬</td>
    </tr>
    <tr>
      <td>PG</td><td>巴布亞新幾內亞</td>
    </tr>
    <tr>
      <td>PY</td><td>巴拉圭</td>
    </tr>
    <tr>
      <td>PE</td><td>秘魯</td>
    </tr>
    <tr>
      <td>PH</td><td>菲律賓</td>
    </tr>
    <tr>
      <td>PN</td><td>皮特肯群島</td>
    </tr>
    <tr>
      <td>PL</td><td>波蘭</td>
    </tr>
    <tr>
      <td>PT</td><td>葡萄牙</td>
    </tr>
    <tr>
      <td>PR</td><td>波多黎各</td>
    </tr>
    <tr>
      <td>QA</td><td>卡塔爾</td>
    </tr>
    <tr>
      <td>RE</td><td>留尼旺</td>
    </tr>
    <tr>
      <td>RO</td><td>羅馬尼亞</td>
    </tr>
    <tr>
      <td>RU</td><td>俄羅斯聯邦</td>
    </tr>
    <tr>
      <td>RW</td><td>盧旺達</td>
    </tr>
    <tr>
      <td>BL</td><td>聖巴瑟米</td>
    </tr>
    <tr>
      <td>SH</td><td>聖赫勒拿、阿森松和特里斯坦達庫尼亞</td>
    </tr>
    <tr>
      <td>KN</td><td>聖基茨和尼維斯</td>
    </tr>
    <tr>
      <td>LC</td><td>聖露西亞</td>
    </tr>
    <tr>
      <td>MF</td><td>聖馬丁</td>
    </tr>
    <tr>
      <td>PM</td><td>聖皮埃爾和密克隆</td>
    </tr>
    <tr>
      <td>VC</td><td>聖文森特和格林納丁斯</td>
    </tr>
    <tr>
      <td>WS</td><td>薩摩亞</td>
    </tr>
    <tr>
      <td>SM</td><td>聖馬利諾</td>
    </tr>
    <tr>
      <td>ST</td><td>聖多美和普林西比</td>
    </tr>
    <tr>
      <td>SA</td><td>沙烏地阿拉伯</td>
    </tr>
    <tr>
      <td>SN</td><td>塞內加爾</td>
    </tr>
    <tr>
      <td>RS</td><td>塞爾維亞</td>
    </tr>
    <tr>
      <td>SC</td><td>塞舌爾</td>
    </tr>
    <tr>
      <td>SL</td><td>獅子山</td>
    </tr>
    <tr>
      <td>SG</td><td>新加坡</td>
    </tr>
    <tr>
      <td>SX</td><td>聖馬丁</td>
    </tr>
    <tr>
      <td>SK</td><td>斯洛伐克</td>
    </tr>
    <tr>
      <td>SI</td><td>斯洛文尼亞</td>
    </tr>
    <tr>
      <td>SB</td><td>所羅門群島</td>
    </tr>
    <tr>
      <td>SO</td><td>索馬利亞</td>
    </tr>
    <tr>
      <td>ZA</td><td>南非</td>
    </tr>
    <tr>
      <td>GS</td><td>南喬治亞及南桑威奇群島</td>
    </tr>
    <tr>
      <td>SS</td><td>南蘇丹</td>
    </tr>
    <tr>
      <td>ES</td><td>西班牙</td>
    </tr>
    <tr>
      <td>LK</td><td>斯里蘭卡</td>
    </tr>
    <tr>
      <td>SR</td><td>蘇利南</td>
    </tr>
    <tr>
      <td>SJ</td><td>斯瓦爾巴和揚馬延</td>
    </tr>
    <tr>
      <td>SZ</td><td>斯威士蘭</td>
    </tr>
    <tr>
      <td>SE</td><td>瑞典</td>
    </tr>
    <tr>
      <td>CH</td><td>瑞士</td>
    </tr>
    <tr>
      <td>TW</td><td>台灣</td>
    </tr>
    <tr>
      <td>TJ</td><td>塔吉克斯坦</td>
    </tr>
    <tr>
      <td>TZ</td><td>坦尚尼亞</td>
    </tr>
    <tr>
      <td>TH</td><td>泰國</td>
    </tr>
    <tr>
      <td>TL</td><td>東帝汶</td>
    </tr>
    <tr>
      <td>TG</td><td>多哥</td>
    </tr>
    <tr>
      <td>TK</td><td>托克勞</td>
    </tr>
    <tr>
      <td>TO</td><td>湯加</td>
    </tr>
    <tr>
      <td>TT</td><td>千里達和多巴哥</td>
    </tr>
    <tr>
      <td>TN</td><td>突尼斯</td>
    </tr>
    <tr>
      <td>TR</td><td>土耳其</td>
    </tr>
    <tr>
      <td>TM</td><td>土庫曼斯坦</td>
    </tr>
    <tr>
      <td>TC</td><td>特克斯和凱科斯群島</td>
    </tr>
    <tr>
      <td>TV</td><td>圖瓦盧</td>
    </tr>
    <tr>
      <td>UG</td><td>烏干達</td>
    </tr>
    <tr>
      <td>UA</td><td>烏克蘭</td>
    </tr>
    <tr>
      <td>AE</td><td>阿聯酋</td>
    </tr>
    <tr>
      <td>UM</td><td>美國小島嶼</td>
    </tr>
    <tr>
      <td>UY</td><td>烏拉圭</td>
    </tr>
    <tr>
      <td>UZ</td><td>烏茲別克斯坦</td>
    </tr>
    <tr>
      <td>VU</td><td>瓦努阿圖</td>
    </tr>
    <tr>
      <td>VE</td><td>委內瑞拉</td>
    </tr>
    <tr>
      <td>VN</td><td>越南</td>
    </tr>
    <tr>
      <td>VG</td><td>英屬維京群島</td>
    </tr>
    <tr>
      <td>VI</td><td>美屬維京群島</td>
    </tr>
    <tr>
      <td>WF</td><td>瓦利斯和富圖納</td>
    </tr>
    <tr>
      <td>EH</td><td>西撒哈拉</td>
    </tr>
    <tr>
      <td>YE</td><td>也門</td>
    </tr>
    <tr>
      <td>ZM</td><td>贊比亞</td>
    </tr>
    <tr>
      <td>ZW</td><td>津巴布韋</td>
    </tr>
    <tr>
      <td>CU</td><td>古巴</td>
    </tr>
    <tr>
      <td>IR</td><td>伊朗</td>
    </tr>
    <tr>
      <td>SY</td><td>敘利亞</td>
    </tr>
    <tr>
      <td>KP</td><td>北韓</td>
    </tr>
  </tbody>
</table>

另見：

- `Class.PolicyService:GetPolicyInfoForPlayerAsync()`，返回有關玩家的策略信息，該信息基於地理位置、年齡組和平台


LocalizationService:GetCountryRegionForPlayerAsync

player

您正在獲取國家/地區信息的玩家。


一個字符串，指示玩家的國家/地區代碼。


根據玩家的客戶端 IP 地理位置返回國家/地區代碼字符串。


返回一個 `Array`，其中每個返回的 `Array` 的元素本身也是一個條目的 `Array`，格式與 `Class.LocalizationTable:GetEntries()` 中描述的相同。返回的 `Array` 中元素的順序與 `Class.LocalizationTable|LocalizationTables` 將被搜索以嘗試為提供的 `Class.Instance` 自動本地化時的順序相同。特定 `Class.LocalizationTable` 中的條目元素的返回順序是不確定的。

此函數返回條目，無論物件是否為具有啟用 `Class.GuiBase2d.AutoLocalize` 的 `Class.GuiBase2d`。物件若為 `Class.GuiBase2d`，實際上不會進行自動本地化，除非啟用 `Class.GuiBase2d.AutoLocalize`。

表的排序如下：

- 首先，它尋找擁有 `Class.GuiBase2d.RootLocalizationTable` 的該物件的最早 `Class.GuiBase2d` 祖先（包括提供的物件）。表將按照 `Class.GuiBase2d.RootLocalizationTable` 中描述的順序附加，經由該 `Class.GuiBase2d.RootLocalizationTable` 的 `Class.LocalizationTable` 祖先向上尋找。如果找不到此類的 `Class.GuiBase2d.RootLocalizationTable`，則在此步驟中不會附加表。若 `instance` 為 `nil`，則在此步驟中不會附加表。
- 接下來，來自 `Class.LocalizationService` 下的 `Class.LocalizationTable` 層級的表將附加。對於每個 `Class.LocalizationService` 的子 `Class.LocalizationTable`，它將從附加到服務的表下的最低後代 `Class.LocalizationTable` 向上附加所有表，一直到服務的子級。如果 `Class.LocalizationService` 沒有子 `Class.LocalizationTable|LocalizationTables`，則此步驟中不會附加表。
- 最後，雲端的 `Class.LocalizationTable` 附加到數組中。如果沒有雲端 `Class.LocalizationTable`，或者雲端 `Class.LocalizationTable` 尚未加載，則此步驟中不會附加表。

此函數不會讓出控制。它不會等待雲端的 `Class.LocalizationTable` 加載。


LocalizationService:GetTableEntries

instance

一個數組的數組，其中每個數組的格式與 `Class.LocalizationTable:GetEntries()` 中描述的相同。


獲取所有用於自動本地化的條目。


'這段代碼示例嘗試為地區

    "fr"（法語）檢索一個 `Translator` 物件。


    `Class.LocalizationService:GetTranslatorForLocaleAsync()` 被包裹在一個

    pcall 中，因為它可能會出錯。如果沒有出錯並且返回一個翻譯器，

    打印 "法語的問候:" 後面跟著 "Hello World!" 的法語翻譯。如果函數出錯，則打印 "GetTranslatorForLocaleAsync

    失敗:" 後面跟著錯誤訊息。'

此函數將語言區域代碼作為參數，並在雲端的 `Class.LocalizationTable` 加載之前會讓出控制，如果可用。然後返回一個可以用於該語言區域進行翻譯的 `Class.Translator` 對象（如果有任何可用的翻譯）。用於本地化的條目是由 `Class.LocalizationService` 下的 `Class.LocalizationTable` 層級提供的條目以及雲端表（如果可用）。這將是由 `Class.LocalizationService:GetTableEntries(nil)` 返回的相同條目集合。

此函數可能會出錯，因此應包裝在 `pcall()` 中。

另見：

- `Class.LocalizationService:GetTranslatorForPlayer()` 獲取與提供玩家的語言區域相對應的翻譯器。此函數已被棄用，不應在新的工作中使用。
- `Class.LocalizationService:GetTranslatorForPlayerAsync()` 讓出控制，直到雲端 `Class.LocalizationTable` 為提供的玩家的語言區域加載完畢，然後獲取與提供玩家的語言區域相對應的翻譯器。


LocalizationService:GetTranslatorForLocaleAsync

locale

一個 Roblox 支持的語言或語言區域代碼。


指定語言區域的 `Class.Translator` 實例。


在雲端的 `Class.LocalizationTable` 為參數語言區域加載之前會讓出控制 - 如果可用。返回一個 `Class.Translator` 實例，以供對提供的語言區域進行翻譯。


'此代碼範例嘗試為本地玩家檢索一個 `Translator` 物件。`Class.LocalizationService:GetTranslatorForPlayerAsync()` 被包裝在 pcall 中，因為它可能會出錯。如果沒有錯誤並返回一個翻譯器，它將翻譯並打印 "Hello World!" 用於玩家的語言。如果函數出錯，它會打印 "GetTranslatorForLocaleAsync failed:" 以及錯誤消息。

`Class.LocalizationService:GetTranslatorForPlayer()` 也可以用來獲取玩家的翻譯器，而不會在函數返回之前造成阻塞。'

此函數將玩家作為參數，返回一個 `Class.Translator` 實例，該實例可以用於對該語言區域進行翻譯（如果有任何可用的翻譯）。用於本地化的條目是由 `Class.LocalizationService` 下的 `Class.LocalizationTable` 層級提供的條目，以及雲端 `Class.LocalizationTable`（如果可用且已加載）。這將是由 `Class.LocalizationService:GetTableEntries(nil)` 返回的相同條目集合。

此函數不會讓出控制。它不會等待雲端的 `Class.LocalizationTable` 加載。

另見：

- `Class.LocalizationService:GetTranslatorForPlayerAsync()` 具有此函數相同的功能，除了它會讓出控制直到雲端 `Class.LocalizationTable` 加載完成。
- `Class.LocalizationService:GetTranslatorForLocaleAsync()`，返回一個翻譯器，用於使用提供的語言區域進行翻譯。


LocalizationService:GetTranslatorForPlayer

您正在獲取 `Class.Translator` 的 `Class.Player`。


返回一個 `Class.Translator`，以供使用已加載的語言區域數據進行翻譯。


此函數將玩家作為參數，並在雲端 `Class.LocalizationTable` 為該玩家的語言區域加載之前會讓出控制，如果可用。然後返回一個可以用於該語言區域進行翻譯的 `Class.Translator` 對象（如果有任何可用的翻譯）。用於本地化的條目是由 `Class.LocalizationService` 下的 `Class.LocalizationTable` 層級提供的條目以及雲端表（如果可用）。這將是由 `Class.LocalizationService:GetTableEntries(nil)` 返回的相同條目集合。

此函數可能會出錯，因此應包裝在 `pcall()` 中。

另見：

- `Class.LocalizationService:GetTranslatorForPlayer()`，功能與此函數相同，只是它不會讓出控制，也不會等待雲端 `Class.LocalizationTable` 為玩家的語言區域加載完畢。此函數已被棄用，不應在新工作中使用。
- `Class.LocalizationService:GetTranslatorForLocaleAsync()`，返回一個翻譯器，用於使用提供的語言區域進行翻譯。


LocalizationService:GetTranslatorForPlayerAsync

在雲端 `Class.LocalizationTable` 為玩家的語言區域加載之前會讓出控制 - 如果可用。返回一個 `Class.Translator` 實例，以供對提供的語言區域進行翻譯。


LocalizationService

此屬性顯示用於核心和內部功能（如 `Class.CoreGui`）本地化的語言區域 ID。返回一個字符串，包含該語言的兩個字母代碼（例如，`en-us`）。


LocalizationService.RobloxLocaleId

用於本地化核心和內部功能的語言區域 ID。


此屬性顯示本地玩家為其操作系統設置的語言區域 ID。

這將返回一個字符串，包含該語言的兩個字母代碼（例如，"en-us"）。

另見 `Class.Player.LocaleId`，用於本地化體驗內容的用戶在其 Roblox 帳戶上設置的語言區域 ID。
當 Roblox 尚未在內部支持該玩家的語言區域時，這將是一個不同的值。


LocalizationService.SystemLocaleId

本地玩家為其操作系統設置的語言區域 ID。


`Instance` 是 Roblox 類別階層中所有類別的基礎類別，可以是 `Class.DataModel` 樹的一部分。

無法直接創建根 `Instance` 物件，但特殊的 `Datatype.Instance.new()` 建構函數通過代碼創建物件，以類別名稱作為參數並返回所創建的物件。

展示如何通過連接到 `Class.Instance.AncestryChanged` 事件來檢測實例的祖先變化。

ChangingPart 的 Parent 隨著時間設置為不同的值。部分的父項是該部分的祖先，因此每當發生變化時，`Class.Instance.AncestryChanged` 事件將被觸發。


當此實例被重新父級化或其任何祖先被重新父級化時觸發。

您可以使用此事件來跟踪 Studio 中實例的刪除，例如在 Explorer 中的手動刪除或通過插件。如果您需要檢測實例是否使用 `Class.Instance:Destroy()` 被銷毀，請使用 `Class.Instance.Destroying` 事件。

Instance.AncestryChanged

child

其 `Class.Instance.Parent|Parent` 屬性改變的實例，可以是這個實例或更遠的祖先，**不一定**是處理程序連接的實例。

parent

當此對象或其任何祖先的 `Class.Instance.Parent` 屬性發生變更時觸發。

這個事件在實例上的任何屬性發生變更時觸發，包括當屬性被設置為 `nil` 時。變更的屬性的名稱將傳遞到連接的函數。

例如，以下代碼片段連接 `attributeChanged()` 函數，使其在部件的任一屬性變更時觸發：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "changed")
end

part.AttributeChanged:Connect(attributeChanged)
```
另見 `Class.Instance:GetAttributeChangedSignal()`，該方法返回在特定給定屬性變更時觸發的事件。

Instance.AttributeChanged

attribute

每當 `Class.Instance` 上的屬性發生變更時觸發。

當物件被加入到工作區時，此片段會打印物件名稱：

當一個對象被父級化到此 `Class.Instance` 後觸發。

注意，在客戶端使用此方法來檢測服務器創建的對象時，索引這些對象的後代時需要使用 `Class.Instance:WaitForChild()`。這是因為對象及其後代不保證會同時從服務器流複製到客戶端。例如：

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- 使用 WaitForChild() 因為後代可能尚未複製
	local head = child:WaitForChild("Head")
end)
```
注意，此事件僅僅對 `Class.Instance` 的直接子項有效。若要捕獲所有後代的事件，請使用 `Class.Instance.DescendantAdded`。

另見 `Class.Instance.ChildRemoved`。

Instance.ChildAdded

當一個對象被父級化到此 `Class.Instance` 後觸發。

Instance.childAdded

這段程式碼會在物件從

工作空間中移除時，印出其名稱：

當一個子項從此 `Class.Instance` 中被移除後觸發。

移除是指對象的父項從這個 `Class.Instance` 更改為其他不是這個 `Class.Instance` 的對象。注意，當子項被銷毀（使用 `Class.Instance:Destroy()`）時，這個事件也會觸發，因為銷毀函數將對象的父項設置為 `nil`。

此事件僅僅對 `Class.Instance` 的直接子項有效。若要捕獲所有後代的事件，請使用 `Class.Instance.DescendantRemoving`。

另見 `Class.Instance.ChildAdded`。

Instance.ChildRemoved

當一個子項從此 `Class.Instance` 中被移除後觸發。

以下範例會打印任何被添加到

工作空間的物件名稱:

這個事件在後代被添加到 `Class.Instance` 後觸發。

由於它會對每個後代觸發，將一個對象父級化到 `Class.Instance` 將會依次觸發此對象及其所有後代的事件。

如果您只關心 `Class.Instance` 的 **直接子項**，則應改用 `Class.Instance.ChildAdded`。

另見 `Class.Instance.DescendantRemoving`。

Instance.DescendantAdded

descendant

當一個後代被添加到 `Class.Instance` 後觸發。

以下範例在任何後代被移除時打印其名稱

從 Workspace 中：

這個事件在父項 `Class.Instance` 的改變前 **立即觸發**，使得 **後代** 實例不再是後代。`Class.Instance:Destroy()|Destroy()` 將會將實例的 `Class.Instance.Parent|Parent` 更改為 `nil`，因此在父級後代上調用該方法將導致此事件被觸發。

由於此事件在後代移除 **之前** 被觸發，因而在此事件觸發時，後代的父項將保持不變。如果後代也是父項的 **直接子項**，則此事件將在 `Class.Instance.ChildRemoved` 之前被觸發。

如果一個後代有子項，此事件將首先與後代一起觸發，然後隨後代一同觸發其後代。

#### 警告

此事件與正在被移除的後代對象一起觸發。
嘗試將後代的 `Class.Instance.Parent|Parent` 設置為其他對象將會失敗。以下是一個演示這一點的示例：

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- 在此函數中不要操作後代的父項！
	-- 此事件因為父項被操作而觸發，而變更尚未發生
	-- 因此，這樣更改父項是有問題的：
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
另見 `Class.Instance.DescendantAdded|DescendantAdded`。

Instance.DescendantRemoving

在 `Class.Instance` 的一個後代被移除之前立即觸發。

此範例展示了在使用即時信號行為時，
被銷毀的實例會保持在原地，直到連接的函數掛起。


此範例展示了當使用延遲信號行為時，實例
在信號觸發之前被摧毀。


只要有連接的函數仍在使用，`Class.Instance` 將永遠不會從內存中刪除。然而，如果函數在任何時候暫停，`Class.Instance` 及其後代將會被設置為其父項為 `nil`。

如果 `Class.Workspace.SignalBehavior` 屬性設置為 `Enum.SignalBehavior.Immediate`，則此事件將在 `Class.Instance` 或其任何祖先被 `Class.Instance:Destroy()` 銷毀之前立即觸發。

如果 `Class.Workspace.SignalBehavior` 屬性設置為 `Enum.SignalBehavior.Deferred`，則此事件將在下次恢復點觸發，即在 `Class.Instance` 或其任何祖先被 `Class.Instance:Destroy()` 銷毀之後。

使用 `Enum.SignalBehavior.Deferred|Deferred` 行為，將腳本連接到其自己的 `Class.Instance.Destroying` 事件是有問題的，因為腳本將在回調被調用之前銷毀（這意味著它將不會執行）。

在 Studio 中刪除 `Class.Instance` 時，例如通過 [Explorer](/studio/explorer) 手動刪除或通過插件，`Class.Instance` 不會被銷毀。相反，父項被設置為 `nil`，您可以通過 `Class.Instance.AncestryChanged` 來跟蹤此變更。

Instance.Destroying

在實例通過 `Class.Instance:Destroy()` 被銷毀之前立即觸發（或推遲到之後）。

此事件每當實例的任何樣式屬性發生變更時觸發，包括當屬性被設置為 `nil` 時。

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("樣式屬性已更改")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

每當實例的任何樣式屬性發生變化，包括當屬性被設置為 `nil` 時，都會觸發。

此方法為實例應用標籤，如果標籤已經應用則不會有任何效果。成功添加標籤將觸發由 `Class.CollectionService:GetInstanceAddedSignal()` 創建的信號，其中包含給定的標籤。

#### 警告

- 客戶端添加的實例標籤將被刪除，如果伺服器稍後在該實例上添加或刪除標籤，因為伺服器會一起復製所有標籤並覆蓋以前的標籤。

- 在對實例標籤時，通常會使用某些資源來賦予標籤功能，例如事件連接或表格。為了防止記憶體洩漏，當不再需要該標籤時，最好清除這些資源（斷開連接，設置為 `nil` 等）。在調用 `Class.Instance:RemoveTag()`、調用 `Class.Instance:Destroy()` 或在連接到 `Class.CollectionService:GetInstanceRemovedSignal()` 返回的信號的函數時執行此操作。

Instance:AddTag

子物件函數返回物件的子物件數組。

Instance:children

此方法銷毀所有實例的子物件和後代。

```
local part = Instance.new("Part")

-- 添加一些閃光
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
如果您不希望銷毀 **所有** 子物件和後代，請使用 `Class.Instance:GetChildren()` 或 `Class.Instance:GetDescendants()` 來循環遍歷這些子物件/後代並選擇要銷毀的物件。例如，以下代碼示例將銷毀所有來自 `Class.Model` 的 `Class.BasePart|BaseParts`：

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

此方法銷毀所有實例的子物件。

演示如何使用 `Class.Instance:Clone()` 來克隆模型。

`Clone()` 創建實例及所有其後代的副本，忽略所有不是 `Class.Instance.Archivable|Archivable` 的實例。根實例的副本由此方法返回，其 `Class.Instance.Parent|Parent` 設置為 `nil`。請注意，如果實例本身的 `Class.Instance.Archivable|Archivable` 設置為 `false`，則此方法將返回 `nil`。

如果在被複製的實例中設置了參考屬性，例如 `Class.ObjectValue.Value`，則副本的屬性值取決於原物件的值：

- 如果參考屬性參考的是也被複製的實例，則副本將參考該副本。
- 如果參考屬性參考的是未被複製的實例，則在副本中維持相同的值。

Instance:Clone

創建實例及所有其後代的副本，忽略不是 `Class.Instance.Archivable|Archivable` 的實例。

Instance:clone

演示如何使用 `Class.Instance:Destroy()` 函數摧毀一個 Part。

這個函數是處理不再需要的物件的正確方法。


將 `Class.Instance.Parent` 屬性設置為 `nil`，鎖定 `Class.Instance.Parent` 屬性，斷開所有連接，並在所有子物件上調用 `Destroy()`。此方法是正確的方法來處置不再需要的物件。

處置不必要的物件非常重要，因為多餘的物件和連接在場所中會使用内存，進而導致隨著時間的推移而產生嚴重的性能問題。

作為最佳實踐，在調用 `Destroy()` 後將任何引用該物件（或其後代）的變數設置為 `nil`。這可以防止你的代碼訪問與該物件相關的任何內容。

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- 不要這樣做：
print(part.Name)  --> "Hello, world"
-- 這樣做以防止上面這行代碼運行：
part = nil
```
一旦 `Class.Instance` 被此方法銷毀，將被鎖定的 `Class.Instance.Parent` 屬性無法重用。要 **暫時** 移除物件而不是銷毀它，請將 `Class.Instance.Parent|Parent` 設置為 `nil`。例如：

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
要在設置的時間後銷毀物件，請使用 `Class.Debris:AddItem()`。

Instance:Destroy

將 `Class.Instance.Parent` 屬性設置為 `nil`，鎖定 `Class.Instance.Parent` 屬性，斷開所有連接，並在所有子物件上調用 `Destroy()`。

Instance:destroy

返回 `Class.Instance` 的第一個祖先，其 `Class.Instance.Name` 等於給定名稱。

此方法向上工作，意味著它從實例的直接 `Class.Instance.Parent` 開始，向 `Class.DataModel` 上升。如果未找到匹配的祖先，則返回 `nil`。

以下代碼片段將查找名為 `Car` 的物件的第一個祖先。

```
local car = object:FindFirstAncestor("Car")
```
欲尋找特定類別的祖先的此方法的變體，請參見 `Class.Instance:FindFirstAncestorOfClass()` 和 `Class.Instance:FindFirstAncestorWhichIsA()`。

Instance:FindFirstAncestor

name

返回 `Class.Instance` 的第一個祖先，其 `Class.Instance.Name` 等於給定名稱。

返回 `Class.Instance` 的第一個祖先，其 `Class.Object.ClassName` 等於給定的 className。

此方法向上工作，意味著它從實例的直接 `Class.Instance.Parent` 開始，向 `Class.DataModel` 上升。如果未找到匹配的祖先，則返回 `nil`。

此方法的常見用途是查找 `Class.BasePart` 所屬的 `Class.Model`。例如：

```
local model = part:FindFirstAncestorOfClass("Model")
```
此方法是 `Class.Instance:FindFirstAncestor()` 的變體，檢查 `Class.Object.ClassName` 屬性，而不是 `Class.Instance.Name`。 `Class.Instance:FindFirstAncestorWhichIsA()` 也存在，使用 `Class.Object:IsA()` 方法以尊重類別繼承。

Instance:FindFirstAncestorOfClass

className

返回 `Class.Instance` 的第一個祖先，其 `Class.Object.ClassName` 等於給定的 className。

返回 `Class.Instance` 的第一個祖先，該祖先對應於 `Class.Object:IsA()` 返回 true 的給定 className。

此方法向上工作，意味著它從實例的直接 `Class.Instance.Parent` 開始，向 `Class.DataModel` 上升。如果未找到匹配的祖先，則返回 `nil`。

與 `Class.Instance:FindFirstAncestorOfClass()` 不同，此方法使用 `Class.Object:IsA()`，尊重類別繼承。例如：

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
因此，以下代碼示例將返回第一個 `Class.BasePart` 祖先，無論它是 `Class.WedgePart`、`Class.MeshPart` 還是 `Class.Part`。

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
另見 `Class.Instance:FindFirstAncestor()`。

Instance:FindFirstAncestorWhichIsA

返回 `Class.Instance` 的第一個祖先，該祖先對應於 `Class.Object:IsA()` 返回 true 的給定 className。

以下將在工作區中尋找名為"Brick"的物件。如果找到，它將把物件的名稱改為"Foo"。

返回 `Class.Instance` 的第一個子物件，該物件具有給定名稱，或者如果不存在這樣的子物件則返回 `nil`。如果可選的 `recursive` 參數為 `true`，此方法將搜索所有後代而不僅限於 `Class.Instance` 的直接子物件。

#### 檢查物件的存在性

如果您需要驗證物件在繼續之前是否存在，則 `FindFirstChild()` 是必需的。嘗試使用點運算子通過名稱索引子物件，如果該子物件不存在，則會拋出錯誤。

```lua
local Workspace = game:GetService("Workspace")

-- 如果部件在工作區中不存在，以下行會報錯
Workspace.Part.Transparency = 0.5
```
更好的方法是使用 `FindFirstChild()` 首先檢查 `Part`，然後使用 `if` 語句運行需要它的代碼。

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### 查找名稱與屬性匹配的子物件

有時候，物件的 `Class.Instance.Name|Name` 與其 `Class.Instance.Parent|Parent` 的屬性相同。在使用點運算子時，如果它們共享名稱，則屬性將優先於子物件。

在以下示例中，對 `Class.Part` 添加了一個名為 `Color` 的 `Class.Folder`，而它還擁有 `Class.Part.Color` 屬性。注意 `part.Color` 是指 `Datatype.Color3` 屬性值，而不是子 `Class.Folder` 實例。使用 `Class.Instance:FindFirstChild()|FindFirstChild()` 的好處是，新屬性的引入不會對您的代碼造成風險。

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- 屬性
local c2 = part:FindFirstChild("Color")  -- 子文件夾
```

#### 性能注意事項

`Class.Instance:FindFirstChild()|FindFirstChild()` 所需時間約比使用點運算子長 20%，而且幾乎長 8 倍於簡單地存儲物件引用。因此，應避免在與性能相關的代碼中調用它，例如在緊密循環中或連接到 `Class.RunService.Heartbeat` 和 `Class.RunService.PreRender` 的函數中。相反，將結果存儲在變數中，或者考慮使用 `Class.Instance.ChildAdded|ChildAdded` 或 `Class.Instance:WaitForChild()|WaitForChild()` 來檢測特定名稱的子物件何時可用。

Instance:FindFirstChild

recursive

返回第一個子物件，該物件具有給定名稱的 `Class.Instance`。

Instance:findFirstChild

返回 `Class.Instance` 的第一個子物件，其 `Class.Object.ClassName|ClassName` 等於給定的 `className`。與 `Class.Instance:FindFirstChildWhichIsA()` 不同，此方法僅返回其類別與 `className` 匹配的物件，忽略類別繼承。如果未找到匹配子物件，則此方法返回 `nil`。

Instance:FindFirstChildOfClass

返回 `Class.Instance` 的第一個子物件，其 `Class.Object.ClassName|ClassName` 等於給定的類名。

返回 `Class.Instance` 的第一個子物件，該子物件符合 `Class.Object:IsA()` 返回 true 的給定 className。

如果未找到匹配子物件，則此方法返回 `nil`。如果可選的 `recursive` 參數為 true，則此方法搜索所有後代，而不僅限於 `Class.Instance` 的直接子物件。

與 `Class.Instance:FindFirstChildOfClass()` 不同，此方法使用 `Class.Object:IsA()`，尊重類別繼承。例如：

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
因此，以下代碼示例將返回第一個 `Class.BasePart` 子物件，無論它是 `Class.WedgePart`、`Class.MeshPart` 還是 `Class.Part`。

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
希望通過名稱查找子物件的開發人員應使用 `Class.Instance:FindFirstChild()`。

Instance:FindFirstChildWhichIsA

返回 `Class.Instance` 的第一個子物件，該子物件符合 `Class.Object:IsA()` 返回 true 的給定 className。

返回第一個後代，該後代符合給定 `Class.Instance.Name`。

此方法被禁用且無法使用。要查找實例的第一個後代，請考慮在 `Class.Instance:FindFirstChild()` 上使用 `recursive` 參數。

Instance:FindFirstDescendant

返回第一個後代，該後代符合給定 `Class.Instance.Name`。

如果 `Class.Instance` 是 `Class.Actor`，則返回 `Class.Actor` 本身。否則，返回其最近的祖先 `Class.Actor`。如果沒有祖先是 `Class.Actor`，結果為 `nil`。

Instance:GetActor

返回與實例相關聯的 `Class.Actor`，如果有的話。

此方法返回分配給給定屬性名稱的值。如果未分配屬性，則返回 `nil`。

例如，以下代碼片段設置並獲取實例的 `InitialPosition` 屬性的值：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### 另見

- `Class.Instance:SetAttribute()`，用於將具有給定名稱的屬性設置為給定值。
- `Class.Instance:GetAttributes()`，返回實例的每個屬性的鍵值對字典。

Instance:GetAttribute

已分配給給定屬性名稱的值。如果未分配屬性，則返回 `nil`。

返回分配給給定屬性名稱的值。

此方法返回一個事件，該事件的行為與 `Class.Object.Changed|Changed` 事件完全相同，只不過它僅在特定給定屬性更改時引發；有效地類似於 `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`，但僅針對屬性。

通常使用此方法而不是連接到 `Class.Object.Changed|Changed` 的函數，這樣會檢查屬性名稱。對於同一物件及相同屬性名稱，後續調用該方法將返回相同的事件。

以下代碼示例返回一個信號，當部件的 `InitialPosition` 屬性更改時會觸發 `attributeChanged()` 函數：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Attribute changed")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
另見 `Class.Instance.AttributeChanged`，這在實例上的任何屬性更改時觸發。

Instance:GetAttributeChangedSignal

指定的屬性名稱，其變更信號正在返回。

當給定屬性更改時觸發的事件。

返回在給定屬性更改時引發的事件。

此方法返回每個屬性的鍵值配對的字典，其中鍵是屬性名稱，值是非 `nil` 值。

例如，以下代碼段輸出實例的屬性和值：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
另見 `Class.Instance:GetAttribute()`，返回已分配給給定屬性名稱的值。

Instance:GetAttributes

屬性的字典，其中鍵是屬性名稱，變體是非 `nil` 值的鍵值對。

下面的代碼會在執行時打印出當前在工作區中的所有物件名稱。

返回一個數組（數字索引表），包含所有實例的直接子物件，或每個 `Class.Instance`，其 `Class.Instance.Parent|Parent` 等於該物件。可以使用數字或通用 `for` 循環對該數組進行迭代：

```lua
local Workspace = game:GetService("Workspace")

-- 數字循環示例
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " 是子物件號 " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- 通用循環示例
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " 是子物件號 " .. i)
end
```
請注意，返回的數組 **不** 以任何特定順序進行排序，因此建議在使用此方法返回的子物件進行排序時進行手動排序（例如使用 `Library.table.sort()`）。

另見 `Class.Instance:GetDescendants()|GetDescendants()` 方法。

Instance:GetChildren

返回包含所有實例子物件的數組。

Instance:getChildren

返回由 Roblox 內部使用的調試 ID 的編碼字符串。請注意：

- 此項目是受保護的。在 `Class.Script` 或 `Class.LocalScript` 中使用它將導致錯誤。
- 調試 ID 是在調試過程中使用的 ID。它允許調試工具在應用程序處理指令之前讀取每條指令。所有 Roblox 中的物件都像進程一樣運行，每個都運行指令（或"代碼"）以便於需要時調試。
- 這對於需要區分彼此相似物件的插件很有幫助（例如，共享相同名稱的物件）。

Instance:GetDebugId

scopeLength

返回由 Roblox 內部使用的調試 ID 的編碼字符串。

GetDescendants 通常用於對所有子孫物件進行某些操作，這些物件是特定類型的物件。這個示例中的程式碼使用 GetDescendants 和 `Class.Instance:IsA()` 來找到工作區中的所有部件並將它們變成綠色。

此物件方法返回一個數組，該數組包含該物件的所有後代。與 `Class.Instance:GetChildren()` 不同，此方法查找該物件的所有子物件、每個子物件的每個子物件，依此類推。

請注意，返回的數組 **不** 以任何特定順序進行排序，因此建議在使用此方法返回的後代進行排序時進行手動排序（例如使用 `Library.table.sort()`）。也請考慮使用 `Class.Instance:QueryDescendants()|QueryDescendants()` 方法通過選擇器和組合子來查詢後代。

Instance:GetDescendants

返回包含實例的所有後代的數組。

此代碼範例演示了 `Class.Instance:GetFullName()` 的行為。

它展示了當在不在 `DataModel` 階層中的物件上調用該函數時的行為，
並且還顯示了返回值如何不轉義特殊字符。

這段代碼示例在 Lua 中重新實作了 `Class.Instance:GetFullName()` 函數。


返回描述實例的祖先的字符串。該字符串是物件的 `Class.Instance.Name|Name` 和其祖先的串聯，以句點分隔。`Class.DataModel` (`game`) 不被考慮。例如，`Class.Workspace` 中的 `Class.Part` 可能返回 `Class.Workspace.Part`。

當在不是 `Class.DataModel` 的後代上調用此方法時，此方法考慮了所有祖先，直到包括沒有 `Class.Instance.Parent|Parent` 的最上層的一個。

此方法對於日誌記錄和調試非常有用。您不應該嘗試解析返回的字符串以用於任何有用的操作；此方法不會在物件名稱中轉義句點（或任何其他符號）。換句話說，儘管其輸出通常看似有效的 Luau 標識符，但不保證它是有效的。

Instance:GetFullName

返回描述實例的祖先的字符串。

此方法返回指定屬性樣式或明確修改的值，否則返回屬性的默認值（如果沒有樣式/修改）。這與直接訪問屬性值稍有不同，例如 `[GuiObject].Rotation`，這返回屬性的默認或修改值。

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- 引用一個按鈕
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (默認值)
print(button.Rotation) --> 0 (默認值)

-- 根據樣式規則屬性應用旋轉
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (根據規則的樣式值)
print(button.Rotation) --> 0 (默認值)

-- 明確修改/覆蓋樣式屬性
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (修改過的值)
print(button.Rotation) --> 45 (修改過的值)
```

Instance:GetStyled

selector

要針對實例中定位的伪實例的可選選擇器。

指定屬性樣式或明確修改的值，否則返回屬性的默認值（如果沒有樣式/修改）。

返回指定屬性樣式或明確修改的值，否則返回屬性的默認值（如果沒有樣式/修改）。

此方法返回一個事件，該事件的行為與 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 事件完全相同，只不過它僅在特定樣式屬性更改時引發。通常使用此方法而不是連接到 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 的函數，這樣會檢查屬性名稱。對於同一物件及相同屬性名稱，後續調用該方法將返回相同的事件。

請注意，該事件不會將任何參數傳遞給已連接的函數，因此必須直接在腳本中讀取更改屬性的值。

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("樣式屬性已更改！")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```

Instance:GetStyledPropertyChangedSignal

property

要監聽更改的樣式屬性的名稱。

當給定樣式屬性更改時觸發的事件。

此方法返回應用於給定實例的標籤數組，以字符串形式表示。您可以在 Studio 中的 [屬性](/studio/properties) 窗口中或在運行時使用 `Class.Instance:AddTag()|AddTag()` 添加標籤。

當您同時希望對實例上的多個標籤執行某些操作時，此方法非常有用。然而，使用此方法檢查單個標籤的存在是低效的；相反，使用 `Class.Instance:HasTag()|HasTag()` 來檢查特定標籤。

Instance:GetTags

獲取應用於實例的所有標籤的數組。

此方法返回 `true`，如果提供的標籤已添加到該物件中。您可以在 Studio 中的 [屬性](/studio/properties) 窗口中或在運行時使用 `Class.Instance:AddTag()|AddTag()` 添加標籤。

Instance:HasTag

示範如何使用
`Class.Instance:IsAncestorOf()`
來判斷一個實例是否是另一個實例的祖先。

Workspace 和 SpawnLocation 是 SpawnLocation 的貼圖的祖先。
Workspace 是 SpawnLocation 的祖先。

SpawnLocation 和其貼圖是 Workspace 的後裔，而不是祖先。
Decal 是 SpawnLocation 的後裔，不是祖先。


如果 `Class.Instance` 是給定後代的祖先，則返回 true。

如果物件的 `Class.Instance.Parent` 或其父物件的 `Class.Instance.Parent` 設置為 `Class.Instance`，則認為該 `Class.Instance` 是物件的祖先。

另見 `Class.Instance:IsDescendantOf()`。

Instance:IsAncestorOf

如果 `Class.Instance` 是給定後代的祖先，則為 true。

如果 `Class.Instance` 是給定後代的祖先，則返回 true。

如果 `Class.Instance` 是給定祖先的後代，則返回 true。

注意 `IsDescendantOf()` 不能使用 `nil` 參數來檢查物件是否已被移除。

另見 `Class.Instance:IsAncestorOf()`。

Instance:IsDescendantOf

ancestor

如果 `Class.Instance` 是給定祖先的後代，則為 true。

如果 `Class.Instance` 是給定祖先的後代，則返回 true。

Instance:isDescendantOf

此方法指示特定屬性是否已經從代碼實例化的默認值進行了修改。如果在通過代碼（`Datatype.Instance.new()`）新創建的實例上調用此方法，則會返回 `false`。如果在通過 Studio 工作流（例如 [Explorer](/studio/explorer) 窗口插入）新創建的物件調用此方法，則結果可能會有差異。

例如，查詢由 [Explorer](/studio/explorer) 插入`Class.TextLabel.BackgroundColor3|BackgroundColor3` 屬性的 `Class.TextLabel` 將返回 `true`，但如果通過 `Datatype.Instance.new()` 創建的 `Class.TextLabel` 的相同屬性將返回 `false`，前提是沒有對其 `Class.TextLabel.BackgroundColor3|BackgroundColor3` 進行其他更改。

注意，此方法僅對服務和用戶可創建的實例返回有用的結果。實例的系統填充屬性的返回值如 `Class.PackageLink` 是未定義的行為。

同樣請注意，如果此方法返回 `true`，則樣式將 **不** 影響該屬性，因為明確修改屬性優先於對其進行樣式設定。要將屬性重置為其代碼實例化的默認值並允許對其進行樣式，應使用 `Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`。

Instance:IsPropertyModified

布爾值，指示該屬性是否從其代碼實例化的默認值中進行了修改。

返回 `true`，如果存儲在指定屬性中的值不等於代碼實例化的默認值。

此物件方法返回一個包含所有匹配所提供的 `selector` 字串的物件後代的陣列。`selector` 可以包括多個選擇器和組合器，以匹配例如類別名稱、實例名稱和階層關係等特徵，以及實例屬性和屬性的特定值。`selector` 的語法與 `Class.StyleRule` 中使用的類似，僅在某些支持的語法部分上有所不同。

#### 選擇器

- `ClassName` — 匹配指定類別的實例，基於 `Class.Object:IsA()` 關係。
- `.Tag` — 匹配被 `Class.CollectionService` 標記的實例。
- `#Name` — 匹配特定 `Class.Instance.Name` 的實例。
- `[property = value]` — 匹配具有指定屬性的實例，且該屬性具有指定值。支持布林值、數字和字串值。字母、數字、`_` 和 `-` 可以直接使用，而不需要將值放在引號中。
- `[$attribute]` — 匹配具有指定 [attribute](/studio/properties#instance-attributes) 的實例。
- `[$attribute = value]` — 匹配具有指定屬性**且**該屬性具有指定值的實例。與屬性選擇器的限制相同。如果想要檢查某個屬性是否缺失，請不要將查詢設為 `nil`；而是使用 `:not` 偽類別，如 `:not([$attribute])`。

選擇器也可以組合。例如，`Model.Apple[$Variety = Fuji][$Flavor = 4]` 將匹配標記為 `Apple` 的 `Class.Model` 實例，並且具有 `Variety` 屬性的值等於 `Fuji` 以及 `Flavor` 屬性的值等於 `4`。

```lua
local Workspace = game:GetService("Workspace")

-- 獲取所有 MeshPart 後代
print(Workspace:QueryDescendants("MeshPart"))

-- 獲取所有標記為 "Fruit" 的後代
print(Workspace:QueryDescendants(".Fruit"))

-- 獲取所有名稱為 "RedTree" 的後代
print(Workspace:QueryDescendants("#RedTree"))

-- 獲取所有 CanCollide 屬性設為 false 的後代
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- 獲取所有指定了 "FuelCapacity" 屬性的後代
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- 獲取所有 "FuelCapacity" 屬性設為 75 的後代
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### 組合器

組合器讓您可以混合基本選擇器，以匹配更深的階層關係。

- `>` — 匹配是前一個過濾器匹配的**直接子項**的實例。

- `>>` — 匹配是前一個過濾器匹配的**後代**的實例。這是預設的第一個過濾器，意味著 `SpotLight.Red` 與 `>> SpotLight.Red` 是相同的。

- `,` — 指定一組多個獨立選擇器，用於後代查詢。僅返回匹配過濾器的元素；在查詢列表中不會包括 `nil` 的未匹配項。

```lua
local Workspace = game:GetService("Workspace")

-- 獲取所有標記為 "SwordPart" 的模型的直接子項
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- 獲取所有是 Part 且標記為 "Apple" 的直接子項
print(Workspace:QueryDescendants("> Part.Apple"))

-- 獲取任何模型的後代，屬性 "OnFire" 設為 true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- 獲取標記為 "SwordPart" 的 MeshPart 後代或具有屬性 "OnFire" 設為 true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### 偽類別選擇器

- `:not(complex-selector-list)` — 允許選擇**不**匹配其中任何選擇器的實例，實際上對選擇器進行否定。由於內部表達式是一組複雜的選擇器，因此可以根據多個條件進行過濾。

- `:has(relative-selector-list)` — 允許根據包含的實例進行選擇。選擇器列表相對於每個實例進行評估。

```lua
local Workspace = game:GetService("Workspace")

-- 獲取所有不是 SpotLight 類別的後代
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- 獲取所有不是 SpotLight 或 PointLight 類別的後代
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- 獲取所有沒有屬性 "OnFire" 的後代
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- 獲取所有除了被標記為 "SwordPart" 的模型的子項的後代
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- 獲取包含工具實例作為其後代的後代
print(Workspace:QueryDescendants(":has(Tool)"))
-- 獲取標記為 "SwordPart" 的直接子項的 MeshPart 後代
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- 獲取具有直接子項不是 SurfaceAppearance 或 Texture 類別的 MeshPart 後代
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

用於過濾元素的選擇器字符串。

匹配選擇器的實例數組（如果沒有匹配的則為空）。

返回一個包含所有匹配 `selector` 字串的實例後代的陣列。


以下代碼示範了如何在被移除後，將一個部件重新添加到數據模型中：

此方法將物件的 `Class.Instance.Parent` 設置為 `nil`，並對其所有後代執行相同操作。

如果在移除之前參考了物件，可以稍後檢索該物件。

Instance:Remove

將物件的 `Parent` 設置為 `nil`，並對其所有後代執行相同操作。

Instance:remove

此方法從實例中移除標籤。如果該物件沒有該標籤，則不會拋出錯誤。成功移除標籤將觸發由 `Class.CollectionService:GetInstanceRemovedSignal()` 創建的信號，其中包含給定的標籤。

請注意，在對實例標籤時，通常會使用某些資源來賦予標籤其功能，例如事件連接或表格。為了防止內存洩漏，當不再需要該標籤時，最好清除這些資源（斷開連接、設置為 `nil` 等）。

Instance:RemoveTag

將屬性重置為其默認值。例如，在 `Class.TextLabel` 上調用 `ResetPropertyToDefault("Rotation")` 相當於將 `Class.TextLabel.Rotation|Rotation` 設置為 `0`（該屬性的默認值）。此方法可以確保樣式會覆蓋該屬性的默認值。

Instance:ResetPropertyToDefault

此方法將具有給定名稱的屬性設置為給定值。如果提供的值為 `nil`，則該屬性將被移除，因為默認情況下返回 `nil`。

例如，以下代碼片段將實例的 `InitialPosition` 屬性設置為 `Datatype.Vector3|Vector3.new(0, 10, 0)`：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

#### 限制

命名要求和限制：

- 名稱必須僅使用字母數字字符。
  - 您還可以包括句點、破折號、斜線和底線。
- 不允許空格或唯一符號（如 @、~、!）。
- 字符串必須不超過 100 個字符。
- 名稱不得以 **RBX** 開頭，除非調用者是 Roblox 內部腳本（保留給 Roblox 使用）。

在嘗試將屬性設置為不支持的類型時，將拋出錯誤。

#### 另見

- `Class.Instance:GetAttribute()`，返回已分配給給定屬性名稱的值。
- `Class.Instance:GetAttributes()`，返回實例的每個屬性的鍵值對字典。

Instance:SetAttribute

value

將具有給定名稱的屬性設置為給定值。

以下代碼會等待一個名為 "Part" 的實例被添加到

    Workspace。

返回具有給定名稱的 `Class.Instance` 的子項。如果子項不存在，將暫停當前線程直到它存在。如果指定了 `timeOut` 參數，則此方法將在指定的秒數後超時並返回 `nil`。

#### 主要用途

`Class.Instance:WaitForChild()|WaitForChild()` 在 `Class.LocalScript` 中處理客戶端代碼時極其重要。Roblox 引擎不保證從服務器複製到客戶端對象的時間或順序。此外，如果體驗的 `Class.Workspace.StreamingEnabled` 設置為 true，則與玩家角色距離較遠的 `Class.BasePart|BaseParts` 可能不會被流式傳輸到客戶端，這可能會導致在索引尚未存在於客戶端的對象時腳本中斷。

#### 注意

- 如果在調用時具有給定名稱的子項存在，則此方法不會暫停。
- `Class.Instance:FindFirstChild()` 是假定存在的對象的更高效替代方案，使用 `Class.Instance:WaitForChild()|WaitForChild()`。
- 如果此方法的調用超過 5 秒而沒有返回，且未指定 `timeOut` 參數，將會在輸出中打印警告，指示線程可能無限期暫停。

Instance:WaitForChild

返回具有給定名稱的 `Class.Instance` 的子項。如果子項不存在，將暫停當前線程直到它存在。

Instance

`Instance` 是 Roblox 類別階層中所有類別的基礎類別，可以是 `Class.DataModel` 樹的一部分。

/reference/engine/classes/LocalizationService.yaml