---
title: ZEPETO.Multiplay.DataStorage
slug: world-sdk-guide-th/zepetomultiplaydatastorage
docTags: 
createdAt: 2026-09-04T04:51:02.242Z
---

| ประเภท                                  | คำอธิบาย                                                                                                                                                                        |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [DataStorageError](./#datastorageerror) | รหัสข้อผิดพลาดที่ระบุสาเหตุความล้มเหลวของคำขอที่เกี่ยวข้องกับที่จัดเก็บข้อมูล                                                                                                   |
| [DataStorage](./#datastorage)           | แทนสิ่งที่เป็นนามธรรมของที่จัดเก็บข้อมูล ซึ่งมีเมธอดสำหรับจัดเก็บ ดึง และลบข้อมูล อินเทอร์เฟซนี้กำหนดการทำงานแบบอะซิงโครนัสสำหรับการจัดการข้อมูลทั้งแบบรายการเดียวและหลายรายการ |

## DataStorageError

`enum`

รหัสข้อผิดพลาดที่ระบุสาเหตุความล้มเหลวของคำขอที่เกี่ยวข้องกับที่จัดเก็บข้อมูล

| ชื่อ                    | ค่า | คำอธิบาย                                                                                                   |
| ----------------------- | --- | ---------------------------------------------------------------------------------------------------------- |
| Unknown                 | -1  | ข้อผิดพลาด: ข้อผิดพลาดที่ไม่ทราบสาเหตุ                                                                     |
| NetworkError            | 0   | ข้อผิดพลาด: ข้อผิดพลาดที่เกี่ยวข้องกับปัญหาเครือข่าย รวมถึงการหลุดการเชื่อมต่อหรือการเชื่อมต่อที่ไม่เสถียร |
| KeyConstraintViolated   | 103 | ข้อผิดพลาด: ข้อผิดพลาดของคีย์                                                                              |
| ValueConstraintViolated | 104 | ข้อผิดพลาด: ข้อผิดพลาดของค่า                                                                               |

## DataStorage

`interface`

แทนสิ่งที่เป็นนามธรรมของที่จัดเก็บข้อมูล ซึ่งมีเมธอดสำหรับจัดเก็บ ดึง และลบข้อมูล
อินเทอร์เฟซนี้กำหนดการทำงานแบบอะซิงโครนัสสำหรับการจัดการข้อมูลทั้งแบบรายการเดียวและหลายรายการ

### เมธอด

### set

`set(key: string, value: T) → Promise<boolean>`

จัดเก็บค่าด้วยคีย์ที่ระบุ โดยจะโยน `DataStorageError`

| พารามิเตอร์ | ประเภท   | คำอธิบาย               |
| ----------- | -------- | ---------------------- |
| key         | `string` | คีย์ที่ใช้ในการจัดเก็บ |
| value       | `T`      | ข้อมูลที่จะจัดเก็บ     |

**ค่าที่คืนกลับ:** `Promise<boolean>` — `Promise` ที่ resolve เมื่อดำเนินการเสร็จสิ้น โดยระบุความสำเร็จ (`true`) หรือความล้มเหลว (`false`)

### get

`get(key: string) → Promise<T>`

ดึงค่าตามคีย์ที่ระบุ โดยจะโยน `DataStorageError`

| พารามิเตอร์ | ประเภท   | คำอธิบาย            |
| ----------- | -------- | ------------------- |
| key         | `string` | คีย์ที่ต้องการค้นหา |

**ค่าที่คืนกลับ:** `Promise<T>` — `Promise` ที่ resolve เมื่อดำเนินการเสร็จสิ้น พร้อมค่าชนิด `T`

### remove

`remove(key: string) → Promise<boolean>`

ลบค่าด้วยคีย์ที่ระบุ โดยจะโยน `DataStorageError`

| พารามิเตอร์ | ประเภท   | คำอธิบาย            |
| ----------- | -------- | ------------------- |
| key         | `string` | คีย์ที่ต้องการค้นหา |

**ค่าที่คืนกลับ:** `Promise<boolean>` — `Promise` ที่ resolve เมื่อดำเนินการเสร็จสิ้น โดยระบุความสำเร็จ (`true`) หรือความล้มเหลว (`false`)

### mget

`mget(keys: string[]) → Promise<{ [key: string]: T }>`

ดึงค่าจากหลายคีย์ โดยจะโยน `DataStorageError`

| พารามิเตอร์ | ประเภท     | คำอธิบาย                       |
| ----------- | ---------- | ------------------------------ |
| keys        | `string[]` | อาร์เรย์ของคีย์ที่ต้องการค้นหา |

**ค่าที่คืนกลับ:** `Promise<{ [key: string]: T }>` — `Promise` ที่ resolve เมื่อดำเนินการเสร็จสิ้น พร้อมอ็อบเจกต์คีย์-ค่า

### mset

`mset(keyValueSet: { key: string; value: T }[]) → Promise<boolean>`

จัดเก็บหลายค่าด้วยคีย์ที่ระบุ โดยจะโยน `DataStorageError`

| พารามิเตอร์ | ประเภท                        | คำอธิบาย                                 |
| ----------- | ----------------------------- | ---------------------------------------- |
| keyValueSet | `{ key: string; value: T }[]` | อาร์เรย์ของอ็อบเจกต์คีย์-ค่าที่จะจัดเก็บ |

**ค่าที่คืนกลับ:** `Promise<boolean>` — `Promise` ที่ resolve เมื่อดำเนินการเสร็จสิ้น โดยระบุความสำเร็จ (`true`) หรือความล้มเหลว (`false`)