SharedBufferReceivedEvent class
イベントの chrome.webview.sharedbufferreceived
イベント オブジェクト。 このイベントは、正常に呼び出されたときに CoreWebView2.PostSharedBufferToScript
ディスパッチされます。
- Extends
注釈
例
次の例では、1 回限りの読み取り専用の使用のためにデータをスクリプトに送信します。
まず、ネイティブ ホスト アプリ コードで、共有メモリにデータを設定します。
wil::com_ptr<ICoreWebView2ExperimentalEnvironment10> environment;
CHECK_FAILURE(
m_appWindow->GetWebViewEnvironment()->QueryInterface(IID_PPV_ARGS(&environment)));
wil::com_ptr<ICoreWebView2ExperimentalSharedBuffer> sharedBuffer;
CHECK_FAILURE(environment->CreateSharedBuffer(bufferSize, &sharedBuffer));
// Add data to shared memory via IStream.
wil::com_ptr<IStream> stream;
CHECK_FAILURE(sharedBuffer->OpenStream(&stream));
CHECK_FAILURE(stream->Write(data, sizeof(data), nullptr));
PCWSTR additionalDataAsJson = L"{\"myBufferType\":\"bufferType1\"}";
if (fromFrame)
{
m_webviewFrame4->PostSharedBufferToScript(
sharedBuffer.get(), COREWEBVIEW2_SHARED_BUFFER_ACCESS_READ_ONLY,
additionalDataAsJson);
}
else
{
m_webView18->PostSharedBufferToScript(
sharedBuffer.get(), COREWEBVIEW2_SHARED_BUFFER_ACCESS_READ_ONLY,
additionalDataAsJson);
}
// Close the one-time shared buffer, to release resources.
sharedBuffer->Close();
HTML ドキュメントで、sharedbufferreceived イベントをサブスクライブして処理します。
次に、HTML ドキュメントで をサブスクライブし、イベントを sharedbufferreceived
処理します。
window.chrome.webview.addEventListener("sharedbufferreceived", e => {
SharedBufferReceived(e);});
let readOnlySharedBuffer;
function ShowReadOnlySharedBuffer() {
if (readOnlySharedBuffer) {
DisplaySharedBufferData(readOnlySharedBuffer);
} else {
// Post a web message to ask host to share the one time read only buffer.
chrome.webview.postMessage("RequestOneTimeShareBuffer");
}
}
function DisplaySharedBufferData(buffer) {
document.getElementById("shared-buffer-data").value =
new TextDecoder().decode(new Uint8Array(buffer));
}
function SharedBufferReceived(e) {
if (e.additionalData && e.additionalData.myBufferType == "bufferType1") {
readOnlySharedBuffer = e.getBuffer();
} else {
sharedBuffer = e.getBuffer();
}
DisplaySharedBufferData(e.getBuffer());
}
function ReleaseBuffer(buffer) {
window.chrome.webview.releaseBuffer(buffer);
}
プロパティ
additional |
パラメーター |
source | イベントのソースは オブジェクトです |
メソッド
get |
|
プロパティの詳細
additionalData
パラメーターCoreWebView2.PostSharedBufferToScript
を JSON 文字列として解析したadditionalDataAsJson
結果である オブジェクト。 このプロパティは、 が nullptr
または 空の文字列の場合additionalDataAsJson
になりますundefined
。
additionalData: any;
プロパティ値
any
source
メソッドの詳細
getBuffer()
ArrayBuffer
に渡された共有バッファーからバッキング コンテンツを持つオブジェクトをCoreWebView2.PostSharedBufferToScript
返します。 バッファーを にReadOnly
設定して呼び出された場合CoreWebView2.PostSharedBufferToScript
は、バッファーへの読み取りアクセスのみが許可されます。 読み取り専用バッファー内のコンテンツを変更しようとすると、WebView レンダラー プロセスでアクセス違反が発生し、レンダラー プロセスがクラッシュします。
getBuffer(): ArrayBuffer;
戻り値
ArrayBuffer
ArrayBuffer
に渡された共有バッファー上の CoreWebView2.PostSharedBufferToScript
。