Skip to content

Commit 37fe498

Browse files
committed
Refine wording of problem description.
1 parent 46903de commit 37fe498

File tree

4 files changed

+42
-1
lines changed

4 files changed

+42
-1
lines changed

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
This repo hosts two separate documents.
22
1. [Capture Handle Identity](https://github.com/WICG/capture-handle/tree/main/identity)
3-
2. ~[Capture Handle Actions](https://github.com/WICG/capture-handle/tree/main/actions)~ (TBD)
3+
2. [Capture Handle Actions](https://github.com/WICG/capture-handle/tree/main/actions)
File renamed without changes.

actions/index.html

+41
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,47 @@ <h2>Abstract</h2>
1616
</p>
1717
</section>
1818
<section id="conformance"></section>
19+
<section>
20+
<h2>Problem Description</h2>
21+
<section id="generic-problem-desc">
22+
<h3>Generic Problem Description</h3>
23+
<p>
24+
Consider a web-application, running in one tab, which we’ll name "<var>main_app</var>."
25+
Assume <var>main_app</var> calls
26+
<a data-cite="SCREEN-CAPTURE#dom-mediadevices-getdisplaymedia">getDisplayMedia</a>
27+
and the user chooses to share another tab, where an application is running which we’ll
28+
call "<var>captured_app</var>."
29+
</p>
30+
<p>Note that:</p>
31+
<ol>
32+
<li><var>main_app</var> does not know what it is capturing.</li>
33+
<li>
34+
<var>captured_app</var> does not know that it is being captured; let alone by whom.
35+
</li>
36+
</ol>
37+
<p>
38+
Both these traits are desirable for the general case, but there exist legitimate use cases
39+
where the browser would want to allow applications to opt-in to bridging that gap and
40+
enable a connection.
41+
</p>
42+
<p>
43+
We wish to enable the legitimate use cases while keeping the general case as it was
44+
before.
45+
</p>
46+
</section>
47+
<section id="use-case-1">
48+
<h3>Use-case #1: Driving Presentations from Video Conferencing Apps</h3>
49+
<p>
50+
Consider a collaborating presentation software and video-conferencing software. Assume the
51+
user is in a VC session. The user starts sharing a presentation. Both applications are
52+
interested in letting the VC app discover that it is capturing a slides session,
53+
so that the VC application will be able to expose
54+
controls to the user for flipping through slides. When the user clicks those controls, the
55+
VC app will be able to send messages to the presentation app, requesting that it do such
56+
things as flip through slides, etc.
57+
</p>
58+
</section>
59+
</section>
1960
<section>
2061
<h2>The Capture-Handle Actions Mechanism</h2>
2162
<p>
File renamed without changes.

0 commit comments

Comments
 (0)