Enable and Configure Interactive Whiteboard Service

To use Agora Interactive Whiteboard, you need to enable and configure the whiteboard service in Agora Console.

Prerequisites

Before enabling the whiteboard feature, ensure that you meet the following requirements:

• A valid Agora account. If you have a Netless account, you must complete the account migration first. See Migrate from Netless to Agora.
• Active Agora projects. If you has not created a project, see Manage Projects.

Enable the whiteboard service

Follow these steps to enable the whiteboard service in Agora Console:

1. Log in to Agora Console, and click the Project Management icon on the left navigation panel.

2. On the Project Management page, find the project for which you want to enable the whiteboard service, and click Edit.
   

3. On the Edit Project page, find Whiteboard, and click Enable.
   

4. Read the pop-up prompt carefully, and click Confirm.
   The Enable button changes to the Config button, which allows you to configure the whiteboard service.
   

Get security credentials for your whiteboard project

Agora Console assigns the following security credentials to each whiteboard project:

• AppIdentifier: The unique App Identifier, which is required for initializing the whiteboard SDK.
• AK and SK: A pair of access keys, which you can use to generate whiteboard tokens. See Generate a Token at App Server.
• sdkToken: An SDK Token (a dynamic key) for test purpose. In a production environment, you need to generate an SDK token at your app server either by using the code samples or calling the RESTful API.

To get the security credentials, do the following steps:

1. On the Project Management page in Agora Console, find the project that has the whiteboard feature enabled, and click Edit.

2. On the Edit Project page, find Whiteboard, and click Config.

3. Navigate to the Basic information section, click the eye icons to copy the AppIdentifier, AK, and SK. Save them to a secure location.
   

4. Click Generate sdk Token, read the pop-up prompt carefully, and then click Copy sdkToken. Save the SDK Token to a secure location.
   

Enable whitebaord server-side features

Agora Interactive Whiteboard provides the following server-side features:

• File conversion, including Docs to Picture and Docs to web.
  After enabling the file conversion feature, you can call the RESTful APIs to launch a file conversion task or query the conversion progress.
  Agora charges for the file-conversion feature. See Pricing.
• Screenshot. After enabling the screenshot feature, you can call the RESTful APIs to take screenshots.

Follow these steps to enable one or more features and configure the storage settings:

1. Go to the Project Management page in Agora Console, find the project that has the whiteboard feature enabled, and click Edit.

2. On the Edit Project page, find Whiteboard, and click Config.

3. Under Services, select Enabled for Docs to Picture, Docs to web, or Screenshot.
   

4. Click the arrowhead to the right of Storage, and select a storage space in the drop-down list:

   • A previously configured third-party storage space: You can select a previously confgured third-party storage space from the list and go to Step 6.
   • New Storage Config: If you have not yet added a third-party storage space, configure a new storage following Step 5.
     

5. Click New Storage Config, and fill in the following information:

   • Vendor: (Required) The third-party cloud storage vendor. Agora supports only Amazon Simple Storage Service (Amazon S3) now.
   • Region: (Required) The location of the data center you specified when creating a bucket.
   • accessKey: (Required) The Access Key provided by the third-party cloud storage vendor, which is used by the vendor to identify visitors.
   • secretKey: (Required) The Secret Key provided by the third-party cloud storage vendor, which is used to authenticate signatures.
   • bucket: (Required) The name of the storage space.
   • Storage path: The path used to save the resources in the storage space. The default is the root directory.
   • Domain: The domain name used to access the third-party cloud storage service.
   • To get the above information about a third-party storage service, see the documentation provided by the vendor.
   • You should enable public access or higher permission for third-party storage spaces so that your app clients can access files saved in the space.

6. Click Save, read the pop-up prompt carefully, and click Confirm.

Reference

After enabling the whiteboard service, you can refer to the following documents to use its functions:

• Join a Whiteboard Room
• File Conversion Overview