Skip to content

Commit

Permalink
Merge pull request #797 from AICC/MrBillMcDonald-patch-19
Browse files Browse the repository at this point in the history
6-16-2023 - Section 11/11.1
  • Loading branch information
MrBillMcDonald authored Jul 7, 2023
2 parents 90260f2 + 38672f8 commit 1ba3377
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions cmi5_spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -1188,11 +1188,11 @@ The LMS MAY place additional values in the <code>contextTemplate</code>.</td></t
<a name="xapi_agent_profile"></a>
# 11.0 xAPI Agent Profile Data Model

In cmi5, Learner Preferences are scoped to the Agent representing the enrolled LMS learner. The Agent used in xAPI Agent Profile requests MUST match the actor property generated by the LMS at AU launch time. Both the LMS and the AU MAY write changes to Learner Preferences in the xAPI Agent Profile. The LMS/LRS MAY choose to ignore or override Learner Preference changes requested by the AU by returning a "403 Forbidden" response as defined in the xAPI specification. The AU MUST NOT treat the 403 response as an error condition.
In cmi5, Learner Preferences are scoped to the Agent representing the enrolled LMS learner. The agent used in xAPI Agent Profile requests MUST match the actor property generated by the LMS at AU launch time. Both the LMS and the AU MAY write changes to Learner Preferences in the xAPI Agent Profile. The LMS/LRS MAY choose to ignore or override Learner Preference changes requested by the AU by returning a "403 Forbidden" response as defined in the xAPI specification. The AU MUST NOT treat the 403 response as an error condition.

The AU MUST retrieve the Learner Preferences document from the Agent Profile on startup.

When reading or writing to the Agent Profile, the document name MUST be "cmi5LearnerPreferences". The document content MUST be a JSON object with the "languagePreference" and "audioPreference" properties as described in Section 11.1 and 11.2. For example:
When reading or writing to the Agent Profile, the document name MUST be "cmi5LearnerPreferences". The document content MUST be a JSON object with the <code>languagePreference</code> and <code>audioPreference</code> properties as described in Section 11.1 and 11.2. For example:

```javascript
{
Expand All @@ -1202,7 +1202,7 @@ When reading or writing to the Agent Profile, the document name MUST be "cmi5Lea
```
<a name="language_preference"></a>
## 11.1 languagePreference
The languagePreference MUST be a comma-separated list of RFC 5646 Language Tags. In the list, languages MUST be specified in order of user preference. In the example below, the user's first preference for language is en-US. The user's second preference for language is fr-FR and the third preference is fr-BE.
The <code>languagePreference</code> MUST be a comma-separated list of RFC 5646 Language Tags. In the list, languages MUST be specified in order of user preference. In the example below, the user's first preference for language is <code>en-US</code>. The user's second preference for language is <code>fr-FR</code> and the third preference is <code>fr-BE</code>.

```javascript
{
Expand All @@ -1211,7 +1211,7 @@ The languagePreference MUST be a comma-separated list of RFC 5646 Language Tags.
}
```

If the AU supports multiple languages, the AU SHOULD display in the language preference order of the user as in the example above. If the AU supported "zh-CN", "fr-BE" and "fr-FR", it SHOULD display in "fr-FR". If the AU does not support multiple languages, or if no languagePreference is specified in the Agent Profile, it MAY display in its default language.
The AU SHOULD display in the language preference order of the user as in the example above (as supported).

<a name="audio_preference"></a>

Expand Down

0 comments on commit 1ba3377

Please sign in to comment.