Unity용 Cloud Storage로 파일 메타데이터 사용

bookmark_border 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Cloud Storage 참조로 파일을 업로드한 후 콘텐츠 유형을 업데이트하는 등 파일 메타데이터를 가져오거나 업데이트할 수 있습니다. 또한 추가 파일 메타데이터로 커스텀 키-값 쌍을 저장할 수 있습니다.

파일 메타데이터 가져오기

파일 메타데이터는 Name, SizeBytes, ContentType(통칭 MIME 형식) 등의 일반적인 속성뿐 아니라 ContentDisposition, CreationTimeMillis 등의 비일반적 속성도 포함합니다. GetMetadataAsync 메서드를 사용하여 Cloud Storage 참조에서 이러한 메타데이터를 가져올 수 있습니다.

// Create reference to the file whose metadata we want to retrieve
StorageReference forestRef =
    storageRef.Child("images/forest.jpg");

// Get metadata properties
forestRef.GetMetadataAsync().ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        StorageMetadata meta = task.Result;
        // do stuff with meta
    }
});

파일 메타데이터 업데이트

파일 업로드가 완료된 후 언제든지 MetadataChange 객체를 취하는 UpdateMetadataAsync 메서드를 사용하여 파일 메타데이터를 업데이트할 수 있습니다. 업데이트할 수 있는 속성에 대한 자세한 내용은 전체 목록을 참조하세요. 메타데이터에 지정된 속성만 업데이트되며 나머지 속성은 그대로 유지됩니다.

// Create reference to the file whose metadata we want to change
StorageReference forestRef = storageRef.Child("images/forest.jpg");

// Create file metadata to update
var newMetadata = new MetadataChange();
newMetadata.CacheControl = "public,max-age=300";
newMetadata.ContentType = "image/jpeg";

// Update metadata properties
forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        // access the updated meta data
        StorageMetadata meta = task.Result;
    }
});

쓰기 가능한 메타데이터 속성에 빈 문자열을 전달하여 삭제할 수 있습니다.

// Create file metadata to update
var newMetadata = new MetadataChange();
newMetadata.ContentType = "";

// Update metadata properties
forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        StorageMetadata meta = task.Result;
        // meta.ContentType should be an empty string now
    }
});

오류 처리

메타데이터를 가져오거나 업데이트할 때 오류가 발생하는 데에는 파일이 없거나 파일에 대한 액세스 권한이 없는 경우 등 다양한 이유가 있습니다. 오류에 대한 자세한 내용은 문서의 오류 처리 섹션을 참조하세요.

커스텀 메타데이터

커스텀 메타데이터를 Dictionary<string, string>으로 지정할 수 있습니다.

var newMetadata = new MetadataChange {
    CustomMetadata = new Dictionary<string, string> {
        {"location", "Yosemite, CA, USA"},
        {"activity", "Hiking"}
    }
};

// UpdateMetadataAsync

커스텀 메타데이터에 각 파일의 앱별 데이터를 저장할 수 있지만 이러한 유형의 데이터를 저장하고 동기화할 때는 Firebase Realtime Database와 같은 데이터베이스를 사용하는 것이 좋습니다.

파일 메타데이터 속성

파일 메타데이터 속성의 전체 목록은 다음과 같습니다.

다음 단계

파일 업로드, 다운로드 및 업데이트도 중요하지만 파일을 삭제할 수도 있어야 합니다. Cloud Storage에서 파일을 삭제하는 방법을 알아보세요.