このページは Cloud Translation API によって翻訳されました。

WebGPU の新機能（Chrome 116）

François Beaufort

WebCodecs の統合

WebGPU は、HTMLVideoElement～importExternalTexture() の不透明な「外部テクスチャ」オブジェクトを作成する API を公開します。これらのオブジェクトを使用すると、ソースの YUV カラーモデルデータから直接、コピーなしでビデオフレームを効率的にサンプリングできます。

ただし、最初の WebGPU 仕様では、WebCodecs の VideoFrame オブジェクトから GPUExternalTexture オブジェクトを作成できませんでした。この機能は、すでに WebCodecs を使用しており、WebGPU を動画処理パイプラインに統合する高度な動画処理アプリにとって重要です。WebCodecs インテグレーションにより、GPUExternalTexture と copyExternalImageToTexture() 呼び出しのソースとして VideoFrame を使用できるようになりました。次の例と chromestatus エントリをご覧ください。

// Access the GPU device.
const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice();

// Create VideoFrame from HTMLVideoElement.
const video = document.querySelector("video");
const videoFrame = new VideoFrame(video);

// Create texture from VideoFrame.
const texture = device.importExternalTexture({ source: videoFrame });
// TODO: Use texture in bind group creation.

WebCodecs を使用した動画のアップロードの試験運用版のサンプルをご覧ください。

GPUAdapter requestDevice() によって返されたデバイスの紛失

GPUAdapter の requestDevice() メソッドが、すでに GPUDevice の作成に使用されているために失敗した場合、null で拒否するプロミスを返すのではなく、すぐに失われたとマークされた GPUDevice を返すようになりました。問題 chromium:1234617 をご覧ください。

const adapter = await navigator.gpu.requestAdapter();
const device1 = await adapter.requestDevice();

// New! The promise is not rejected anymore with null.
const device2 = await adapter.requestDevice();
// And the device is immediately marked as lost.
const info = await device2.lost;

importExternalTexture() が呼び出された場合に動画の再生をスムーズにする

HTMLVideoElement で importExternalTexture() が呼び出されると、動画がビューポートに表示されない場合、関連する動画再生はスロットリングされなくなります。問題 chromium:1425252 をご覧ください。

仕様の適合性

GPUPipelineError() コンストラクタの message 引数は省略可能です。chromium:4613967 の変更をご覧ください。

WGSL ソース code に \0 が含まれている場合、createShaderModule() を呼び出すときにエラーが発生します。問題 dawn:1345 をご覧ください。

createSampler() でテクスチャをサンプリングするときに使用されるデフォルトの最大詳細レベル（lodMaxClamp）は 32 です。変更 chromium:4608063 をご覧ください。

デベロッパーエクスペリエンスの向上

サポートされていないプラットフォームで WebGPU を使用している場合、デベロッパーに注意を促すメッセージが DevTools JavaScript コンソールに表示されます。chromium:4589369 の変更をご覧ください。

getMappedRange() が失敗すると、デベロッパーがキューにコマンドを送信しなくても、バッファ検証エラーメッセージが DevTools JavaScript コンソールにすぐに表示されます。chromium:4597950 の変更をご覧ください。

バッファ検証のエラーメッセージが表示されている DevTools JavaScript コンソールのスクリーンショット。 — DevTools JavaScript コンソールのバッファ検証エラーメッセージ。

Dawn の更新

disallow_unsafe_apis デバッグ切り替えボタンの名前を allow_unsafe_apis に変更し、デフォルトで無効にしました。この切り替えボタンをオンにすると、API エントリポイントまたはまだ安全と見なされていないパラメータの組み合わせの検証エラーが抑制されます。これはデバッグに役立ちます。問題 dawn:1685 をご覧ください。

wgpu::ShaderModuleWGSLDescriptor の非推奨の source 属性は削除され、code に置き換えられました。変更 dawn:130321 をご覧ください。

不足していた wgpu::RenderBundle::SetLabel() メソッドを実装しました。変更 dawn:134502 をご覧ください。

アプリは、wgpu::RequestAdapterOptionsBackendType オプションを使用してアダプターを取得するときに、特定のバックエンドをリクエストできます。以下の例と問題 dawn:1875 をご覧ください。

wgpu::RequestAdapterOptionsBackendType backendTypeOptions = {};
backendTypeOptions.backendType = wgpu::BackendType::D3D12;

wgpu::RequestAdapterOptions options = {};
options.nextInChain = &backendTypeOptions;

// Request D3D12 adapter.
myInstance.RequestAdapter(&options, myCallback, myUserData);

新しい SwapChain::GetCurrentTexture() メソッドが追加され、スワップチェーンテクスチャの使用方法が追加されました。これにより、戻り値 wgpu::Texture をコピーで使用できるようになりました。以下の例と問題 dawn:1551 をご覧ください。

wgpu::SwapChain swapchain = myDevice.CreateSwapChain(mySurface, &myDesc);
swapchain.GetCurrentTexture();
swapchain.Present();

以下に、主なハイライトをいくつかご紹介します。コミットの一覧（すべて網羅）をご覧ください。