Title Storage に blob をアップロードする - XBOX Game Development Documentation

このトピックでは、次のフラット C コード例を使用して XBOX サービス Title Storage に blob をアップロードする方法を示します。

XblTitleStorageUploadBlobAsync のパラメーターに関する注意事項

アップロードする blob データを含むバッファーは、非同期操作の期間中は有効である必要があります。アップロード進行中にバッファーを変更してはいけません。
preferredUploadBlockSize を指定しなかった場合、または既定のサイズが許容範囲内でない場合、このメソッドは既定のサイズを使用します。最小サイズは 1,024 バイトです。最大サイズは 4,194,304 バイトです。既定のサイズは 262,144 バイトです。
バイナリ blob は、preferredUploadBlockSize を超える場合、そのサイズの複数のチャンクに分割してアップロードされます。その場合は、より大きいサイズを使用することをお勧めします。タイムアウトが発生する場合は、より小さいサイズで再アップロードを試してください。

Flat C

auto asyncBlock = std::make_unique<XAsyncBlock>();
asyncBlock->queue = queue;
asyncBlock->context = blobBuffer.get();
asyncBlock->callback = [](XAsyncBlock* asyncBlock)
{
    std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };    // Take over ownership of XAsyncBlock*.
    std::unique_ptr<std::vector<uint8_t>> blobBuffer{ static_cast<std::vector<uint8_t>*>(asyncBlock->context) };
    HRESULT hr = XblTitleStorageUploadBlobResult(asyncBlock, &blobMetadata);
};

XblTitleStorageBlobMetadata blobMetadata{};
pal::strcpy(blobMetadata.displayName, displayName.size() + 1, displayName.c_str());
pal::strcpy(blobMetadata.serviceConfigurationId, XBL_SCID_LENGTH, scid);
pal::strcpy(blobMetadata.blobPath, blobPath.size() + 1, blobPath.c_str());
blobMetadata.storageType = storageType;
blobMetadata.blobType = blobType;
time(&blobMetadata.clientTimestamp);

HRESULT hr = XblTitleStorageUploadBlobAsync(
    xboxLiveContext,
    blobMetadata,
    reinterpret_cast<const uint8_t*>(blobBuffer->data()),
    blobBufferSize,
    eTagMatchCondition,
    preferredUploadBlockSize, //    Optional .
    asyncBlock.get()
);

if (SUCCEEDED(hr))
{
    // The call succeeded, so release std::unique_ptr ownership of XAsyncBlock* because
    // the callback takes over ownership. If the call fails, however, std::unique_ptr keeps
    // ownership and deletes XAsyncBlock*.
    asyncBlock.release();
    blobBuffer.release();
}

関連項目

XAsyncBlock XblTitleStorageBlobMetadata XblTitleStorageUploadBlobAsync XblTitleStorageUploadBlobResult

最終更新日 2026年8月25日

関連トピック

Title Storage のサンプルコードハウツーゲームパッケージを作成し Partner Center にアップロードする最初のユーザー生成コンテンツを公開する Title Storage から blob をダウンロードする

⌘I