Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Skema untuk definisi tipe
<a name="schema-for-type-definitions"></a>

Bagian berikut merinci skema yang digunakan untuk definisi tipe.

## $ id
<a name="definition-schema-id"></a>

Elemen $id mengidentifikasi definisi skema. Itu harus mengikuti struktur ini:
+ Mulai dengan awalan `/schema-versions/` URI
+ Sertakan `definition` jenis skema
+ Gunakan garis miring maju (`/`) sebagai pemisah jalur URI
+ Sertakan identitas skema, dengan fragmen yang dipisahkan oleh periode () `.`
+ Gunakan `@` karakter untuk memisahkan ID skema dan versi
+ Akhiri dengan versi semver, menggunakan period (`.`) untuk memisahkan fragmen versi

Identitas skema harus dimulai dengan namespace root yang panjangnya 3-12 karakter, diikuti oleh sub-namespace dan nama opsional.

Versi semver mencakup versi MAJOR (hingga 3 digit), versi MINOR (hingga 3 digit), dan versi PATCH opsional (hingga 4 digit).

**catatan**  
Anda tidak dapat menggunakan ruang nama `aws` yang dipesan atau `matter`

**Example Contoh $ id**  

```
/schema-version/capability/aws.Recording@1.0
```

## $ ref
<a name="definition-schema-ref"></a>

``Elemen $ref mereferensikan definisi tipe yang ada dalam sistem. Ini mengikuti kendala yang sama dengan elemen. `$id`

**catatan**  
Definisi atau kemampuan tipe harus ada dengan nilai yang disediakan dalam `$ref` file.

**Example Contoh $ ref**  

```
/schema-version/definition/aws.capability@1.0
```

## name
<a name="definition-schema-name"></a>

Elemen nama adalah string yang mewakili nama entitas dalam dokumen skema. Ini sering berisi singkatan dan harus mengikuti aturan ini:
+ Hanya berisi karakter alfanumerik, titik (.), garis miring maju (/), tanda hubung (-), dan spasi
+ Mulailah dengan surat
+ Maksimal 192 karakter

Elemen nama digunakan di UI dan dokumentasi konsol Amazon Web Services.

**Example Contoh nama**  

```
Door Lock
On/Off
Wi-Fi Network Management
PM2.5 Concentration Measurement
RTCSessionController
Energy EVSE
```

## title
<a name="definition-schema-title"></a>

Elemen judul adalah string deskriptif untuk entitas yang diwakili oleh dokumen skema. Ini dapat berisi karakter apa pun dan digunakan dalam dokumentasi.

**Example Judul contoh**  

```
Real-time Communication (RTC) Session Controller
Energy EVSE Capability
```

## deskripsi
<a name="definition-schema-description"></a>

`description`Elemen memberikan penjelasan rinci tentang entitas yang diwakili oleh dokumen skema. Ini dapat berisi karakter apa pun dan digunakan dalam dokumentasi.

**Example Deskripsi contoh**  

```
Electric Vehicle Supply Equipment (EVSE) is equipment used to charge an Electric Vehicle (EV) or Plug-In Hybrid Electric Vehicle. 
            This capability provides an interface to the functionality of Electric Vehicle Supply Equipment (EVSE) management.
```

## Ekstrinsicid
<a name="definition-schema-extrinsicid"></a>

`extrinsicId`Elemen tersebut mewakili pengenal yang dikelola di luar sistem IoT Amazon Web Services. Untuk kemampuan Matter, ia memetakan ke`clusterId`,`attributeId`,`commandId`,`eventId`, atau`fieldId`, tergantung pada konteksnya.

`extrinsicId`Dapat berupa bilangan bulat desimal stringifikasi (1-10 digit) atau bilangan bulat heksadesimal stringifikasi (awalan 0x atau 0X, diikuti oleh 1-8 digit heksadesimal).

**catatan**  
Untuk AWS, Vendor ID (VID) adalah 0x1577, dan untuk Matter, itu adalah 0. Sistem memastikan bahwa skema khusus tidak menggunakan VID yang dicadangkan ini untuk kemampuan.

**Example Contoh Extrinsicids**  

```
0018
0x001A
0x15771002
```

## ExtrinsicProperties
<a name="definition-schema-extrinsicproperties"></a>

`extrinsicProperties`Elemen berisi seperangkat properti yang didefinisikan dalam sistem eksternal tetapi dipertahankan dalam model data. Untuk kemampuan Matter, ia memetakan ke berbagai elemen yang tidak dimodelkan atau sebagian dimodelkan dalam cluster, atribut, perintah, atau peristiwa ZCL.

Properti Ekstrinsik harus mengikuti kendala ini:
+ Nama properti harus alfanumerik tanpa spasi atau karakter khusus
+ Nilai properti dapat berupa nilai skema JSON
+ Maksimal 20 properti

Sistem ini mendukung berbagai`extrinsicProperties`, termasuk`access`,`apiMaturity`,`cli`,`cliFunctionName`, dan lain-lain. Properti ini memfasilitasi ACL untuk AWS (dan sebaliknya) transformasi model data.

**catatan**  
Properti ekstrinsik didukung untuk`action`,, `event``property`, dan elemen `struct` bidang kemampuan, tetapi tidak untuk kemampuan atau cluster itu sendiri.