Руководство по API для проекторов EPSON - настройка и управление (EN)

Terms of Use

Terms of Use Terms of Use for “Web API Specifications for Projectors” Seiko Epson Corporation December 2024 1. The copyright for "Web API Specifications for Projectors" (hereinafter referred to as "this document") belongs to Seiko Epson Corporation (hereinafter referred to as "the Company"). You may print one copy of this document and use it only for the express purpose of using our projector products. You may not reproduce, reprint, modify, or send this document, in whole or in part, without our prior permission. 2. The contents of this document are subject to change without notice. Make sure you understand these points before use. 3. This document is used at the customer's own risk.

In no event shall the Company be liable for any direct, indirect, special, accidental, consequential, or any other damages arising from the customer's use, or inability to use, this document. © 2024 Seiko Epson Corporation Page 2/42

Стр. 2

Contents

Contents Summary Summary Application Type of Web API Content Playback For controlling projector Operating Conditions Content Playback Web API Projector Control Web API Security Enable API Authentication Authentication Information Content-Type Request Response Content Playback Sample Developer's Menu Content Playback Sample Projector Control Sample Windows 10 Command Prompt Projector Control Sample List of Supported Models Windows 10 Command Prompt List of Supported Models 1 List of Supported Models 2 List of Supported Models 3 Content Playback V01 Content Playback V01 Remote Functions Power on Power off Content Playback Function Start Playlist for Specified ID Stop Playlist Error Response Series 400 Error Series 500 Error Content Playback V02 Content Playback V02 Remote Functions Power control Switch Source A/V Mute Control Content Playback Function Content Playback Control Error Response Content Playback V03 General Errors Content Playback V03 Data Management Function Acquire Data Information List Upload data Content Playback Function Delete data Acquire playlist information list © 2024 Seiko Epson Corporation Page 3/42

Стр. 3

Contents

Contents Register a New Playlist Edit Playlist Acquire data ID from playlist Delete Playlist Acquire playlist information (for playlist being played) Acquire maximum number of data entries that can be registered to the playlist Acquire information about Overlay Effects for Sources Setting Overlay Effects for Sources Acquire Setting Range for Overlay Effects Time Table Acquire Time Table information (for that day only) Enable/Disable Time Table Settings Upload Time Table (by file) Delete Time Tables Error Response Reload project data General Errors Projector Control V01 Projector Control V01 Projector Control Function Execute ESCVP21 Commands Error Response General Errors Appendix Appendix Trademarks © 2024 Seiko Epson Corporation Page 4/42

Стр. 4

Summary

Summary Contents Application This document applies to the Web API used between Seiko Epson projectors and external control devices. This outlines the URI format of the Web API and the corresponding operation. Type of Web API Content Playback This is the Web API for controlling the content playback function, which operates only when the content playback function is turned on. The URI Path is: /api/v**/contentmgr For supported models, see the List of Supported Models page. For controlling projector This is the Web API for controlling the projector itself. The ESC/VP21 commands are used as the parameters. For details on the ESC/VP21 commands, see the "ESC/VP21 Commands User's Guide".

The URI Path is: /api/v**/control/escvp21 For supported models, see the List of Supported Models page. Operating Conditions Content Playback Web API You can use the content playback Web API when the following three conditions are met. 1. The Web API is On Setting type: Network Settings Turn on the Web API from the projector's [Network Settings] menu. For the details, see the User's Guide for the model you are using. Setting type: Developer's Menu Open the [Developer's Menu] (see below) in your web browser, and then set Enable API to On. The setting type varies depending on your projector model. See the List of Supported Models page. 2.

The projector is on or in standby mode and ready to communicate The following are the standby modes in which communication is possible. The Standby Mode is set to Communication On, and communication is being performed with the specified communication port (wireless LAN/wired LAN). 3. Content Playback is set to On Turn on Content Playback from the projector's [Settings] menu. Projector Control Web API You can use the Projector Control Web API when the following two conditions are met. 1. The Web API is On Turn on the Web API from the projector's [Network Settings] menu. For the details, see the User’s Guide for the model you are using. 2.

The projector is on or in standby mode and ready to communicate The following are the standby modes in which communication is possible. The Standby Mode is set to Communication On, and communication is being performed with the specified communication port (wireless LAN/wired LAN). Security © 2024 Seiko Epson Corporation Page 5/42

Стр. 5