Chromium Code Reviews| Index: chrome/common/extensions/docs/templates/intros/dial.html |
| diff --git a/chrome/common/extensions/docs/templates/intros/dial.html b/chrome/common/extensions/docs/templates/intros/dial.html |
| new file mode 100644 |
| index 0000000000000000000000000000000000000000..9d84882f83911337d7a18737af9e4c1f8968cb38 |
| --- /dev/null |
| +++ b/chrome/common/extensions/docs/templates/intros/dial.html |
| @@ -0,0 +1,30 @@ |
| +<p>The <code>chrome.dial</code> API is backed by a service that multicasts |
| +discovery requests on the local network to discover DIAL-capable devices and |
| +maintains a list of devices that have responded. Adding an onDeviceList |
| +listener causes the service to periodically issue discovery requests to maintain |
| +the device list. (No polling is done when there are no onDeviceList listeners.) |
| +</p> |
| + |
| +<p>The onDeviceList event is fired when discovery respnses are received and in |
| +other circumstances; see the documentation for onDeviceList.</p> |
| + |
| +<p>The client can request that network discovery can be done immediately by |
| +invoking discoverNow() which is useful for presenting the user with an |
| +updated list of devices.</p> |
| + |
| +<p>On-demand use (updates when discoverNow() is called): |
| +<pre> |
| +chrome.dial.onDeviceList.addListener(function (list) { updateMenu(list); }); |
| +chrome.dial.discoverNow(); |
| +</pre> |
| +(Remember to remove the listener when the menu closes.)</p> |
| + |
| +<p>Background use (updates only when periodic polling happens):</p> |
| + |
| +<pre> |
| +var myList; |
| +chrome.dial.onDeviceList.addListener(function (list) { myList = list; }); |
| +</pre> |
| + |
| +<p>These can be combined to poll for devices to prime the device menu, then |
| +refresh the menu when it is displayed.</p> |
|
epeterson
2013/06/20 23:07:40
Here's the chrome.dial intro.
I added a public tem
|