The average writer is used to prolonged periods of focusing and typing away at their keyboard. Although oice users have it more convenient, for the director, it is easier to import directly instead of dragging and dropping.

oice now supports this function.

Currently, oice only supports the importing: background, dialogue and narration. However, user is able to define the main storylines using these three functions. When performing the “director task” in the oice editor, users are able to further tune these changes. This article will briefly explain how to use the text import function of the editor.

1. Defining the character and background attributes

The first part of the script is the Declaration Area, as shown below:

<declaration> </declaration>

A pair of tags surround the definitions. Each document may only have one defined declaration area (<declaration></declaration>). The declaration area consists of the character and background assets. Format is as follows:

<declaration>
[wong]=113
[keung]=104
[A][email protected]{street}=541
</declaration>

In the example above, the text surrounded by the brackets (square brackets, [] ) is used to define a character. While the text surrounded by the braces (curly brackets {} ) are for the background. The name inside the curly brackets is the label of the background.


In the example above, the definition of [A][email protected] is to link asset ID=86 to the label “[A]”, and name as “bystander”. However, some character cannot simply be renamed.

The numbers after the equal “=” sign is the unique ID for the asset. This ID can be found in the asset library as shown in the images below:

Asset ID

2. Script

The second part of the script is the script area, scoped by the tags pair

<script> </script>

Each document must have only one <script> </script> script area, script area defines “Character Dialog”, “Narration”, “Background” elements, format is as follows.

<script>
{street}
[wong]:have you eaten lunch today?
[keung]:No I havent。
how about you?
[A]: I haven’t aswell。
[keung]:your fault again?
[narr]: that is how they went into a fistfight
</script>

When oice sees braces {} it will render it as a background element, and following the brackets with a colon []: will be a character dialogue. Behind [narr]: will be the sentences of the narration. narr is a special keyword that cannot use a character label keyword.


Put the two sections above together into a single text document:

<declaration>
[wong]=113
[keung]=104
[A]=86
{street}=541
</declaration><script>
{street}
[wong]:have you eaten lunch today?
[keung]:No I havent。
how about you?
[A]: I haven’t aswell。
[keung]:your fault again?
[narr]: that is how they went into a fistfight
</script>

Import button


After that in the oice editing interface, click the “Import” button, select the text file, then oice will put your text file into the system.

Did this answer your question?