<?xml version="1.0" encoding="US-ASCII"?>
<!-- This template is for creating an Internet Draft using xml2rfc,
     which is available here: http://xml.resource.org. -->
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
<!-- One method to get references from the online citation libraries.
     There has to be one entity for each item to be referenced.
     An alternate method (rfc include) is described in the references. -->

<!ENTITY RFC0821 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.0821.xml">
<!ENTITY RFC2821 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2821.xml">
<!ENTITY RFC5321 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.5321.xml">
<!-- <!ENTITY I-D.hellstrom-slim-modalitypref PUBLIC "" "http://xml.resource.org/public/rfc/bibxml3/reference.I-D.hellstrom-slim-modalitypref.xml"> -->
<!ENTITY RFC3261 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.3261.xml">
<!ENTITY RFC4566 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4566.xml">
<!ENTITY RFC8255 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.8255.xml">
]>


<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
<!-- used by XSLT processors -->
<!-- For a complete list and description of processing instructions (PIs),
     please see http://xml.resource.org/authoring/README.html. -->
<!-- Below are generally applicable Processing Instructions (PIs) that most I-Ds might want to use.
     (Here they are set differently than their defaults in xml2rfc v1.32) -->
<?rfc strict="yes" ?>
<!-- give errors regarding ID-nits and DTD validation -->
<!-- control the table of contents (ToC) -->
<?rfc toc="yes"?>
<!-- generate a ToC -->
<?rfc tocdepth="4"?>
<!-- the number of levels of subsections in ToC. default: 3 -->
<!-- control references -->
<?rfc symrefs="yes"?>
<!-- use symbolic references tags, i.e, [RFC2119] instead of [1] -->
<?rfc sortrefs="yes" ?>
<!-- sort the reference entries alphabetically -->
<!-- control vertical white space
     (using these PIs as follows is recommended by the RFC Editor) -->
<?rfc compact="yes" ?>
<!-- do not start each main section on a new page -->
<?rfc subcompact="no" ?>
<!-- keep one blank line between list items -->
<!-- end of list of popular I-D processing instructions -->
<rfc 
     category="std"
     docName="draft-ietf-slim-negotiating-human-language-21"
     ipr="trust200902"
    >
  <!-- category values: std, bcp, info, exp, and historic
     ipr values: full3667, noModification3667, noDerivatives3667
     you can add the attributes updates="NNNN" and obsoletes="NNNN"
     they will automatically be output with "(if approved)" -->

  <!-- ***** FRONT MATTER ***** -->

  <front>
    <!-- The abbreviated title is used in the page header - it is only necessary if the
         full title is longer than 39 characters -->

    <title abbrev="Negotiating Human Language">Negotiating Human Language in Real-Time Communications
    </title>

    <author fullname="Randall Gellens" initials="R." 
            surname="Gellens">
      <organization>Core Technology Consulting</organization>

      <address>

        <email>rg+ietf@coretechnologyconsulting.com</email>
        <uri>http://www.coretechnologyconsulting.com</uri>
      </address>
    </author>

    <date  year="2018" />

    <!-- If the month and year are both specified and are the current ones, xml2rfc will fill
         in the current day for you. If only the current year is specified, xml2rfc will fill
     in the current day and month for you. If the year is not the current one, it is
     necessary to specify at least a month (xml2rfc assumes day="1" if not specified for the
     purpose of calculating the expiry date).  With drafts it is normally sufficient to
     specify just the year. -->

    <!-- Meta-data Declarations -->

    <area>ART</area>

    <workgroup>Network Working Group</workgroup>

    <keyword>SDP</keyword>
    <keyword>language</keyword>
    <keyword>human language</keyword>
    <keyword>SIP</keyword>
    <keyword>SLIM</keyword>

    <!-- Keywords will be incorporated into HTML output
         files in a meta tag but they have no effect on text or nroff
         output. If you submit your draft to the RFC Editor, the
         keywords will be used for the search engine. -->

    <abstract>
      <t>
      Users have various human (natural) language needs, abilities, and preferences regarding spoken, written, and signed languages.  This document adds new SDP media-level attributes so that when establishing interactive communication sessions ("calls"), it is possible to negotiate (communicate and match) the caller's language and media needs with the capabilities of the called party.  This is especially important with emergency calls, where a call can be handled by a call taker capable of communicating with the user, or a translator or relay operator can be bridged into the call during setup, but this applies to non-emergency calls as well (as an example, when calling a company call center).
      </t>
      <t>
      This document describes the need and a solution using new Session Description Protocol (SDP) media attributes.
      </t>

    </abstract>

  </front>

  <middle>

    <section title="Introduction">

    <t>
    A mutually comprehensible language is helpful for human communication.  This document addresses the negotiation of human (natural) language and media modality (spoken, signed, written) in real-time communications.  A companion document <xref target="RFC8255"/> addresses language selection in email.
    </t>
    <t>
    Unless the caller and callee know each other or there is contextual or out-of- band information from which the language(s) and media modalities can be determined, there is a need for spoken, signed, or written languages to be negotiated based on the caller's needs and the callee's capabilities. This need applies to both emergency and non-emergency calls. For example, it is helpful for a caller to a company call center or a Public Safety Answering Point (PSAP) to be able to indicate preferred signed, written, and/or spoken languages, and for the callee to be able to indicate its capabilities in this area, allowing the call to proceed using the language(s) and media forms supported by both.    
</t>
    <t>
    For various reasons, including the ability to establish multiple streams using different media (e.g., voice, text, video), it makes sense to use a per-stream negotiation mechanism known as the Session Description Protocol (SDP). Utilizing Session Description Protocol (SDP) <xref target="RFC4566"/> enables the solution described in this document to be applied to all interactive communications negotiated using SDP, in emergency as well as non-emergency scenarios.    
    </t>
    <t>
    By treating language as another SDP attribute that is negotiated along with other aspects of a media stream, it becomes possible to accommodate a range of users' needs and called party facilities. For example, some users may be able to speak several languages, but have a preference. Some called parties may support some of those languages internally but require the use of a translation service for others, or may have a limited number of call takers able to use certain languages. Another example would be a user who is able to speak but is deaf or hard-of-hearing and and desires a voice stream to send spoken language plus a text stream to receive written language. Making language a media attribute allows the standard session negotiation mechanism to handle this by providing the information and mechanism for the endpoints to make appropriate decisions.    
    </t>
    <t>
    The term "negotiation" is used here rather than "indication" because human language (spoken/written/signed) can be negotiated in the same manner as media (audio/text/video) and codecs. For example, if we think of a user calling an airline reservation center, the user may have a set of languages he or she speaks, with perhaps preferences for one or a few, while the airline reservation center will support a fixed set of languages. Negotiation should select the user's most preferred language that is supported by the call center. Both sides should be aware of which language was negotiated.
    </t>
    <t>
    In the offer/answer model used here, the offer contains a set of languages per media (and direction) that the offerer is capable of using, and the answer contains one language per media (and direction) that the answerer will support.  Supporting languages and/or modalities can require taking extra steps, such as having a call handled by an agent who speaks a requested language and/or with the ability to use a requested modality, or bridging external translation or relay resources into the call, etc.  The answer indicates the media and languages that the answerer is committing to support (possibly after additional steps have been taken).  This model also provides knowledge so both ends know what has been negotiated.  Note that additional steps required to support the indicated languages or modalities may or may not be in place in time for any early media.
    </t>
    <t>
    Since this is a protocol mechanism, the user equipment (UE client) needs to know the user's preferred languages; while this document does not address how clients determine this, reasonable techniques could include a configuration mechanism with a default of the language of the user interface; in some cases, a UE could tie language and media preferences, such as a preference for a video stream using a signed language and/or a text or audio stream using a written/spoken language.
    </t>

    <section title="Applicability">

    <t>
    Within this document, it is assumed that the negotiating endpoints have already been determined, so that a per-stream negotiation based on the Session Description Protocol (SDP) can proceed.
    </t>
    <t>When setting up interactive communications sessions it is necessary to route signaling messages to the appropriate endpoint(s). This document does not address the problem of language-based routing.
    </t>
    
    </section> <!-- title="Applicability" -->

    </section> <!-- title="Introduction" -->
    
    <section title="Terminology">
      <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 <xref target="RFC8174">RFC 8174</xref> when, and only when, they appear in all capitals, as shown here.</t>
    </section>

    <!-- <section title="Expected Use">
    <t>
    This facility may be used by NENA and 3GPP.  NENA has already referenced it in NENA 08-01 (i3 Stage 3 version 2) in describing attributes of calls presented to an ESInet, and may add further details in that or other documents.  3GPP may reference this mechanism in general call handling and emergency call handling.  Some CRs introduced in SA1 have anticipated this functionality being provided within SDP.
    </t>
    </section> -->
    
<!-- 
    <section title="Example Use Cases">
        <section title="Emergency Call from English Speaker in Spain">
        <t>
        Someone who speaks only English is visiting Spain and places an emergency (112) call.  The call offers an audio stream using English.  The ESInet and PSAP have policy-based routing rules that take into account the SDP language request when deciding how to route and process the call.  The ESInet routes the call to a PSAP within Spain where an English-speaking call taker is available, and the PSAP selects an English-speaking call taker to handle the call.  The PSAP answers the offer with an audio stream using English.  The call is established with an audio stream; the caller and call taker communicate in English.
        </t>
        <t>
        Alternatively, the ESInet routes the call to a cooperating PSAP within the U.K.  The PSAP answers the offer with an audio stream using English.  The call is established with an audio stream; the caller and call taker communicate in English.  (This approach is similar to that envisioned in REACH112 Total Conversation.)
        </t>
        </section>
        <section title="Emergency Call from Spanish/English Speaker in France">
        <t>
        Someone who speaks both Spanish and English (but prefers Spanish) is visiting France and places an emergency (112) call.  The call offers an audio stream listing first Spanish (meaning most preferred) and then English.  The ESInet and PSAP have policy-based routing rules that take into account the SDP language request when deciding how to route and process the call.  The ESInet routes the call to a PSAP within France where a Spanish-speaking call taker is available, and the PSAP selects a Spanish-speaking call taker to handle the call.  The PSAP answers the offer with an audio stream listing Spanish.  The call is established with an audio stream; the caller and call taker communicate in Spanish.
        </t>
        <t>
        Alternatively, the ESInet routes the call to a cooperating PSAP in Spain or England.  (This approach is similar to that envisioned in REACH112 Total Conversation.)
        </t>
        <t>
        Alternatively, there is no ESInet or the ESInet does not take language into account in its PBR.  The call is routed to a PSAP in France.  The PSAP ignores the language information in the SDP offer, and answers the offer with an audio stream with no language or with French.  The UE continues the call anyway.  The call taker answers in French, the user tries speaking Spanish and perhaps English.  The call taker bridges in a translation service or transfers the call to a multilingual call taker.
        </t>
        </section>
        <section title="Call to Call Center from Russian Speaker in U.S.">
        <t>
        A Russian speaker is visiting the U.S. and places a call to her airline reservation desk to inquire about her return flight.  The airline call processing system takes into account the SDP language request and decides to route the call to its call center within Russia.
        </t>
        <t>Alternatively, if the airline call processing system does not look at SDP, it uses the SIP "hint" if present.
        </t>
        </section>
        <section title="Emergency Call from speech-impaired caller in the U.S.">
        <t>
        Someone who uses English but is speech-impaired places an emergency (911) call.  The call offers an audio stream listing English and a real-time text stream also using English.  The ESInet and PSAP have policy-based routing rules that take into account the SDP language and media requests when deciding how to route and process the call.  The ESInet routes the call to a PSAP with real-time text capabilities.  The PSAP answers the offer with an audio stream listing English and a real-time text stream listing English.  The call is established with an audio and a real-time text stream; the caller and call taker communicate in English using voice from the call-taker to the caller and text from the caller to the call taker.  The audio stream is two-way, allowing the call taker to hear background sounds.
        </t>
        </section>
        <section title="Emergency Call from deaf caller in the U.S.">
        <t>
        A deaf caller who uses American Sign Language (ASL) places an emergency (911) call.  The call offers a video stream listing ASL and an audio stream with no language indicated.  The ESInet and PSAP have policy-based routing rules that take into account the SDP language and media needs when deciding how to route and process the call.  The ESInet routes the call to a PSAP.  The PSAP answers the offer with an audio stream listing English and a video stream listing ASL.  The PSAP bridges in a sign language interpreter.  The call is established with an audio and a video stream.
        </t>
        </section>
    </section>
 -->

    <section title="Desired Semantics">
    <t>
    The desired solution is a media attribute (preferably per direction) that may be used within an offer to indicate the preferred language(s) of each (direction of a) media stream, and within an answer to indicate the accepted language.  The semantics of including multiple languages for a media stream within an offer is that the languages are listed in order of preference.
    </t>
    
    <t>
    (Negotiating multiple simultaneous languages within a media stream is out of scope of this document.)
    </t>
    </section>

    <section anchor="existing" title="The existing 'lang' attribute">
    
    <t>
    RFC 4566 <xref target="RFC4566"/> specifies an attribute 'lang' which appears similar to what is needed here, but is not sufficiently
specific or flexible for the needs of this document.  In addition, 'lang' is not mentioned in <xref target="RFC3264"/> and there are no known implementations in SIP.  Further, it is useful to be able to specify language per direction (sending and receiving).  This document therefore defines two new attributes.
    </t>

    </section>

    <section title="Solution">
    <t>
    An SDP attribute (per direction) seems the natural choice to negotiate human (natural) language of an interactive media stream, using the language tags of BCP 47 <xref target="RFC5646"/>.
    </t>
    
    <!-- <section title="Rationale">
    <t>The decision to base the proposal at the media negotiation level, and specifically to use SDP, came after significant debate and discussion.  From an engineering standpoint, it is possible to meet the objectives using a variety of mechanisms, but none are perfect.  None of the proposed alternatives was clearly better technically in enough ways to win over proponents of the others, and none were clearly so bad technically as to be easily rejected.  As is often the case in engineering, choosing the solution is a matter of balancing trade-offs, and ultimately more a matter of taste than technical merit.  The two main proposals were to use SDP and SIP.  SDP has the advantage that the language is negotiated with the media to which it applies, while SIP has the issue that the languages expressed may not match the SDP media negotiated (for example, a session could negotiate a signed language at the SIP level but fail to negotiate a video media stream at the SDP layer).
    </t>
    <t>The mechanism described here for SDP can be adapted to media negotiation protocols other than SDP.
    </t>
    </section> -->
    
    <section anchor="new" title="The 'hlang-send' and 'hlang-recv' attributes">
    
    <t>
    This document defines two media-level attributes starting with 'hlang' (short for "human interactive language") to negotiate which human language is selected for use in each interactive media stream.  (Note that not all streams will necessarily be used.)  There are two attributes, one ending in "-send" and the other in "-recv", registered in <xref target="IANA"/>.  Each can appear in offers and answers for media streams. 
    </t>

    <!-- <t>
    <list>
        <t>
        a=hlang-send:&lt;language tag&gt;
        </t>
        <t>
        a=hlang-recv:&lt;language tag&gt;
        </t>
    </list>
    </t> -->

        <t>
        In an offer, the 'hlang-send' value is a list of one or more language(s) the offerer is willing to use when sending using the media, and the 'hlang-recv' value is a list of one or more language(s) the offerer is willing to use when receiving using the media.  The list of languages is in preference order (first is most preferred).  When a media is intended for interactive communication using a language in one direction only (e.g., a user with difficulty speaking but able to hear who indicates a desire to send using text and receive using audio), either hlang-send or hlang-recv MAY be omitted.  When a media is not primarily intended for language (for example, a video or audio stream intended for background only) both SHOULD be omitted.  Otherwise, both SHOULD have the same value.  Note that specifying different languages for each direction (as opposed to the same or essentially the same language in different modalities) can make it difficult to complete the call (e.g., specifying a desire to send audio in Hungarian and receive audio in Portuguese).
        </t>
        <!--The two SHOULD NOT be set to languages which are difficult to match together (e.g., specifying a desire to send audio in Hungarian and receive audio in Portuguese will make it difficult to successfully complete the call).-->
        <t>
        In an answer, 'hlang-send' is the language the answerer will send if using the media for language (which in most cases is one of the languages in the offer's 'hlang-recv'), and 'hlang-recv' is the language the answerer expects to receive if using the media for language (which in most cases is one of the languages in the offer's 'hlang-send').
        </t>
        <t>
        In an offer, each value MUST be a list of one or more language tags per BCP 47 <xref target="RFC5646"/>, separated by white space.  In an answer, each value MUST be one language tag per BCP 47.  BCP 47 describes mechanisms for matching language tags.  Note that <xref target="RFC5646"/> Section 4.1 advises to "tag content wisely" and not include unnecessary subtags.
        </t>
<!-- 
        <t>
        In an offer, a list of language tags MAY have an asterisk appended at the end.  An asterisk appended to any value in any media in an offer indicates a request by the caller to the callee to not fail the call if there is no language in common.  See <xref target="advisory"/> for more information and discussion.
        </t>
        <t>An asterisk appended to any value in any media in an answer is undefined.</t>
        <t>Note that separate work may introduce additional information regarding language/modality preferences among media.</t>
 -->
        <t>
        When placing an emergency call, and in any other case where the language cannot be inferred from context, in an offer each media stream primarily intended for human language communication SHOULD specify both (or for asymmetrical language use, one of) the 'hlang-send' and 'hlang-recv' attributes.
        </t>
<!-- 
        <t>
        Note that while signed language tags are used with a video stream to indicate sign language, a video stream in parallel with an audio stream, both using the exact same (spoken) language tag, indicates a request for a supplemental video stream to see the speaker.
        </t>
 -->
        
        <t>
        Clients acting on behalf of end users are expected to set one or both 'hlang-send' and 'hlang-recv' attributes on each media stream primarily intended for human communication in an offer when placing an outgoing session, and either ignore or take into consideration the attributes when receiving incoming calls, based on local configuration and capabilities.  Systems acting on behalf of call centers and PSAPs are expected to take into account the attributes when processing inbound calls.
        </t>
        
        <t>Note that media and language negotiation might result in more media streams being accepted than are needed by the users (e.g., if more preferred and less preferred combinations of media and language are all accepted).  This is not a problem.</t>
    </section>
    
    <section anchor="advisory" title="No Language in Common">
    <t>
    A consideration with the ability to negotiate language is if the call proceeds or fails if the callee does not support any of the languages requested by the caller.  This document does not mandate either behavior.
<!-- 
    , although it does provide a way for the caller to indicate a preference for the call succeeding when there is no language in common.  It is OPTIONAL for the callee to honor this preference.  For example, a PSAP is likely to attempt the call even without an indicated preference when there is no language in common, while a call center might choose to fail the call.
    </t>
    <t>The mechanism for indicating this preference is that, in an offer, if the last token of any 'hlang-recv' or 'hlang-send' value for any media is an asterisk, this indicates a request to not fail the call.  The called party MAY ignore the indication, e.g., for the emergency services use case, regardless of the absence of an asterisk, a PSAP will likely not fail the call; some call centers might reject a call even if the offer contains an asterisk.
 -->
    </t>
    <t>
    If the call is rejected due to lack of any languages in common, it is suggested to use SIP response code 488 (Not Acceptable Here) or 606 (Not Acceptable) <xref target="RFC3261"/> and include a Warning header field <xref target="RFC3261"/> in the SIP response.  The Warning header field contains a warning code of [TBD: IANA VALUE, e.g., 308] and a warning text indicating that there are no mutually-supported languages; the text SHOULD also contain the supported languages and media.
    </t>
    
    <t>Example:

<?rfc subcompact="yes" ?>
        <list>
            <t>
                <list style="hanging">
                    <t hangText="Warning:">[TBD: IANA VALUE, e.g., 308] proxy.example.com "Incompatible language specification:  Requested languages not supported.  Supported languages are: es, en; supported media are: audio, text."</t>
                </list>
            </t>
        </list>
<?rfc subcompact="no" ?>
    </t>
    </section>
    
    <section title="Usage Notes">

   <t>A sign-language tag with a video media stream is interpreted as an indication for sign language in the video stream.  A non-sign-language tag with a text media stream is interpreted as an indication for written language in the text stream.  A non-sign-language tag with an audio media stream is interpreted as an indication for spoken language in the audio stream.</t>

   <t>This document does not define any other use for language tags in
   video media (such as how to indicate visible captions in the video
   stream).</t>

   <t>In the IANA registry of language subtags per BCP 47 <xref target="RFC5646"/>, a
   language subtag with a Type field "extlang" combined with a Prefix
   field value "sgn" indicates a sign-language tag.  The absence of
   such "sgn" prefix indicates a non-sign-language tag.</t>

   <t>This document does not define the use of sign-language tags in text
   or audio media.</t>

   <t>This document does not define the use of language tags in media
   other than interactive streams of audio, video, and text (such as
   "message" or "application").  Such use could be supported by future
   work or by application agreement.</t>

    </section>


    <section anchor="examples" title="Examples">

    <t>Some examples are shown below.  For clarity, only the most directly relevant portions of the SDP block are shown.</t>

<?rfc subcompact="yes"?>

    <t>
    An offer or answer indicating spoken English both ways:
    <list>
        <t>m=audio 49170 RTP/AVP 0</t>
        <t>a=hlang-send:en</t>
        <t>a=hlang-recv:en</t>
    </list>
    </t>
    
    <t>
    An offer indicating American Sign Language both ways:
    <list>
        <t>m=video 51372 RTP/AVP 31 32</t>
        <t>a=hlang-send:ase</t>
        <t>a=hlang-recv:ase</t>
    </list>
    </t>

    <t>
    An offer requesting spoken Spanish both ways (most preferred), spoken Basque both ways (second preference), or spoken English both ways (third preference):
    <list>
        <t>m=audio 49250 RTP/AVP 20</t>
        <t>a=hlang-send:es eu en</t>
        <t>a=hlang-recv:es eu en</t>
    </list>
    </t>

    <t>
    An answer to the above offer indicating spoken Spanish both ways:
    <list>
        <t>m=audio 49250 RTP/AVP 20</t>
        <t>a=hlang-send:es</t>
        <t>a=hlang-recv:es</t>
    </list>
    </t>

    <t>
    An alternative answer to the above offer indicating spoken Italian both ways (as the callee does not support any of the requested languages but chose to proceed with the call):
    <list>
        <t>m=audio 49250 RTP/AVP 20</t>
        <t>a=hlang-send:it</t>
        <t>a=hlang-recv:it</t>
    </list>
    </t>
    
    <t>
    An offer or answer indicating written Greek both ways:
    <list>
        <t>m=text 45020 RTP/AVP 103 104</t>
        <t>a=hlang-send:gr</t>
        <t>a=hlang-recv:gr</t>
    </list>
    </t>

    <t>
    An offer requesting the following media streams: video for the caller to send using Argentine Sign Language, text for the caller to send using written Spanish (most preferred) or written Portuguese, audio for the caller to receive spoken Spanish (most preferred) or spoken Portuguese:
    <list>
        <t>m=video 51372 RTP/AVP 31 32</t>
        <t>a=hlang-send:aed</t>
        <t/>
        <t>m=text 45020 RTP/AVP 103 104</t>
        <t>a=hlang-send:sp pt</t>
        <t/>
        <t>m=audio 49250 RTP/AVP 20</t>
        <t>a=hlang-recv:sp pt</t>
    </list>
    </t>

    <t>
    An answer for the above offer, indicating text in which the callee will receive written Spanish, and audio in which the callee will send spoken Spanish.  The answering party had no video capability:
        <list>
        <t>m=video 0 RTP/AVP 31 32</t>
        <t>m=text 45020 RTP/AVP 103 104</t>
        <t>a=hlang-recv:sp</t>
        <t/>
        <t>m=audio 49250 RTP/AVP 20</t>
        <t>a=hlang-send:sp</t>
    </list>
    </t>

    <t>
    An offer requesting the following media streams: text for the caller to send using written English (most preferred) or written Spanish, audio for the caller to receive spoken English (most preferred) or spoken Spanish, supplemental video:
    <list>
        <t>m=text 45020 RTP/AVP 103 104</t>
        <t>a=hlang-send:en sp</t>
        <t/>
        <t>m=audio 49250 RTP/AVP 20</t>
        <t>a=hlang-recv:en sp</t>
        <t/>
        <t>m=video 51372 RTP/AVP 31 32</t>
    </list>
    </t>

    <t>
    An answer for the above offer, indicating text in which the callee will receive written Spanish, audio in which the callee will send spoken Spanish, and supplemental video:
        <list>
        <t>m=text 45020 RTP/AVP 103 104</t>
        <t>a=hlang-recv:sp</t>
        <t/>
        <t>m=audio 49250 RTP/AVP 20</t>
        <t>a=hlang-send:sp</t>
        <t/>
        <t>m=video 51372 RTP/AVP 31 32</t>
    </list>
    </t>

<?rfc subcompact="no" ?>

    <t>
    Note that, even though the examples show the same (or essentially the same) language being used in both directions (even when the modality differs), there is no requirement that this be the case.  However, in practice, doing so is likely to increase the chances of successful matching. 
    </t>

    </section> <!-- title="Examples" -->

    </section>

    <section anchor="IANA" title="IANA Considerations">

        <section title="att-field Table in SDP Parameters">

    <t>
    IANA is kindly requested to add two entries to the 'att-field (media level only)' table of the SDP parameters registry:
    </t>

    <t>The first entry is for hlang-recv:</t>

    <t>
<?rfc subcompact="yes" ?>
        <list style="hanging">
            <t hangText="Attribute Name:       ">hlang-recv</t>
            <t hangText="Contact Name:         ">Randall Gellens</t>
            <t hangText="Contact Email Address:">
                    rg+ietf@coretechnologyconsulting.com</t>
            <t hangText="Attribute Value:      ">hlang-value</t>
            <t hangText="Attribute Syntax:     ">

                <list style="hanging">
                    <t hangText="hlang-value =">hlang-offv / hlang-ansv</t>
                    <t hangText="                   "> ; hlang-offv used in offers</t>
                    <t hangText="                   "> ; hlang-ansv used in answers</t>
                    <t hangText="hlang-offv  =">Language-Tag *( SP Language-Tag ) <!-- [ SP asterisk ] --></t>
                    <t hangText="                   "> ; Language-Tag as defined in BCP 47</t>
                    <!-- <t hangText="asterisk    ="> "*" &nbsp; ; an asterisk (%x2A)  ~~>character</t> -->
                    <t hangText="SP          ="> 1*" " ; one or more space (%x20) characters</t>
                    <t hangText="hlang-ansv  =">Language-Tag</t>
                </list>
             </t><t/>

            <t hangText="Attribute Semantics:  ">Described in <xref target="new"/> of TBD: THIS DOCUMENT</t>
            <t hangText="Usage Level:          ">media</t>
            <t hangText="Mux Category:         ">NORMAL</t>
            <t hangText="Charset Dependent:    ">No</t>
            <t hangText="Purpose:              ">See <xref target="new"/> of TBD: THIS DOCUMENT</t>
            <t hangText="O/A Procedures:       ">See <xref target="new"/> of TBD: THIS DOCUMENT</t>
            <t hangText="Reference:            ">TBD: THIS DOCUMENT</t>
        </list>
<?rfc subcompact="no" ?>
    </t>

    <t>The second entry is for hlang-send:</t>

    <t>
<?rfc subcompact="yes" ?>
        <list style="hanging">
            <t hangText="Attribute Name:       ">hlang-send</t>
            <t hangText="Contact Name:         ">Randall Gellens</t>
            <t hangText="Contact Email Address:">
                    rg+ietf@coretechnologyconsulting.com</t>
            <t hangText="Attribute Value:      ">hlang-value</t>
            <t hangText="Attribute Syntax:     ">

                <list style="hanging">
                    <t hangText="hlang-value =">hlang-offv / hlang-ansv</t>
                </list>
             </t><t/>
            <t hangText="Attribute Semantics:  ">Described in <xref target="new"/> of TBD: THIS DOCUMENT</t>
            <t hangText="Usage Level:          ">media</t>
            <t hangText="Mux Category:         ">NORMAL</t>
            <t hangText="Charset Dependent:    ">No</t>
            <t hangText="Purpose:              ">See <xref target="new"/> of TBD: THIS DOCUMENT</t>
            <t hangText="O/A Procedures:       ">See <xref target="new"/> of TBD: THIS DOCUMENT</t>
            <t hangText="Reference:            ">TBD: THIS DOCUMENT</t>
        </list>
<?rfc subcompact="no" ?>
    </t>

        </section>  <!-- title="att-field Table in SDP Parameters" -->


        <section title="Warn-Codes Sub-Registry of SIP Parameters">
        
        <t>
        IANA is requested to add a new value in the warn-codes sub-registry of SIP parameters in the 300 through 329 range that is allocated for indicating problems with keywords in the session description.  The reference is to this document.  The warn text is "Incompatible language specification:  Requested languages not supported.  Supported languages and media are: [list of supported languages and media]."
        </t>

        </section> <!-- title="Warn-Codes Sub-Registry of SIP Parameters"-->

    </section> <!-- title="IANA Considerations" -->

    <section title="Security Considerations">
      <t>
      The Security Considerations of BCP 47 <xref target="RFC5646"/> apply here.  In addition, if the 'hlang-send' or 'hlang-recv' values are altered or deleted en route, the session could fail or languages incomprehensible to the caller could be selected; however, this is also a risk if any SDP parameters are modified en route.
      </t>
    </section>
    
    <section title="Privacy Considerations">
        <t>Language and media information can suggest
   a user's nationality, background, abilities, disabilities, etc.</t>
   </section>

    <section title="Changes from Previous Versions">
    
    <t>RFC EDITOR: Please remove this section prior to publication.</t>

    <section title="Changes from draft-ietf-slim-...-04 to draft-ietf-slim-...-06">
        <t>
        <list style="symbols">
            <t>Deleted Section 3 ("Expected Use")</t>
            <t>Reworded modalities in Introduction from "voice,
   video, text" to "spoken, signed, written"</t>
            <t>Reworded text about "increasingly fine-grained distinctions" to instead merely point to BCP 47 Section 4.1's advice to "tag content wisely" and not include unnecessary subtags</t>
            <t>Changed IANA registration of new SDP attributes to follow RFC 4566 template with extra fields suggested in 4566-bis (expired draft)</t>
            <t>Deleted "(known as voice carry over)"</t>
            <t>Changed textual instanced of RFC 5646 to BCP 47, although actual reference remains RFC due to xml2rfc limitations</t>
        </list>
        </t>
     </section>

    <section title="Changes from draft-ietf-slim-...-02 to draft-ietf-slim-...-03">
        <t>
        <list style="symbols">
            <t>Added Examples</t>
            <t>Added Privacy Considerations section</t>
            <t>Other editorial changes for clarity</t>
        </list>
        </t>
     </section>

    <section title="Changes from draft-ietf-slim-...-01 to draft-ietf-slim-...-02">
        <t>
        <list style="symbols">
            <t>Deleted most of <xref target="existing"/> and replaced with a very short summary</t>
            <t>Replaced "wishes to" with "is willing to" in <xref target="new"/></t>
            <t>Reworded description of attribute usage to clarify when to set both, only one, or neither</t>
            <t>Deleted all uses of "IMS"</t>
            <t>Other editorial changes for clarity</t>
        </list>
        </t>
     </section>

    <section title="Changes from draft-ietf-slim-...-00 to draft-ietf-slim-...-01">
        <t>
        <list style="symbols">
            <t>Editorial changes to wording in Section 5.</t>
        </list>
        </t>
     </section>

    <section title="Changes from draft-gellens-slim-...-03 to draft-ietf-slim-...-00">
        <t>
        <list style="symbols">
            <t>Updated title to reflect WG adoption</t>
        </list>
        </t>
     </section>

    <section title="Changes from draft-gellens-slim-...-02 to draft-gellens-slim-...-03">
        <t>
        <list style="symbols">
            <t>Removed Use Cases section, per face-to-face discussion at IETF 93</t>
            <t>Removed discussion of routing, per face-to-face discussion at IETF 93</t>
        </list>
        </t>
     </section>
      <section title="Changes from draft-gellens-slim-...-01 to draft-gellens-slim-...-02">
        <t>
        <list style="symbols">
            <t>Updated NENA usage mention</t>
            <t>Removed background text reference to draft-saintandre-sip-xmpp-chat-04 since that draft expired</t>
        </list>
        </t>
     </section>

      <section title="Changes from draft-gellens-slim-...-00 to draft-gellens-slim-...-01">
        <t>
        <list style="symbols">
            <t>Revision to keep draft from expiring
            </t>
        </list>
        </t>
     </section>

      <section title="Changes from draft-gellens-mmusic-...-02 to draft-gellens-slim-...-00">
        <t>
        <list style="symbols">
            <t>Changed name from -mmusic- to -slim- to reflect proposed WG name
            </t>
            <t>As a result of the face-to-face discussion in Toronto, the SDP vs SIP issue was resolved by going back to SDP, taking out the SIP hint, and converting what had been a set of alternate proposals for various ways of doing it within SIP into an informative annex section which includes background on why SDP is the proposal
            </t>
            <t>Added mention that enabling a mutually comprehensible language is a general problem of which this document addresses the real-time side, with reference to <xref target="RFC8255" /> which addresses the non-real-time side.
            </t>
        </list>
        </t>
     </section>

      <section title="Changes from draft-gellens-mmusic-...-01 to -02">
        <t>
        <list style="symbols">
            <t>Added clarifying text on leaving attributes unset for media not primarily intended for human language communication (e.g., background audio or video).
            </t>
            <t>Added new section  ("Alternative Proposal: Caller-prefs") discussing use of SIP-level Caller-prefs instead of SDP-level.</t>
        </list>
        </t>
     </section>
     
      <section title="Changes from draft-gellens-mmusic-...-00 to -01">
        <t>
        <list style="symbols">
            <t>Relaxed language on setting -send and -receive to same values; added text on leaving on empty to indicate asymmetric usage.
            </t>
            <t>Added text that clients on behalf of end users are expected to set the attributes on outgoing calls and ignore on incoming calls while systems on behalf of call centers and PSAPs are expected to take the attributes into account when processing incoming calls.
            </t>
        </list>
        </t>
     </section>

      <section title="Changes from draft-gellens-...-02 to draft-gellens-mmusic-...-00">
        <t>
        <list style="symbols">
            <t>Updated text to refer to RFC 5646 rather than the IANA language subtags registry directly.</t>
            <t>Moved discussion of existing 'lang' attribute out of "Proposed Solution" section and into own section now that it is not part of proposal.</t>
            <t>Updated text about existing 'lang' attribute.</t>
            <t>Added example use cases.</t>
            <t>Replaced proposed single 'hlang' attribute with 'hlang-send' and 'hlang-recv' per Harald's request/information that it was a misuse of SDP to use the same attribute for sending and receiving.</t>
            <t>Added section describing usage being advisory vs required and text in attribute section.</t>
            <t>Added section on SIP "hint" header (not yet nailed down between new and existing header).</t>
            <t>Added text discussing usage in policy-based routing function or use of SIP header "hint" if unable to do so.</t>
            <t>Added SHOULD that the value of the parameters stick to the largest granularity of language tags.</t>
            <t>Added text to Introduction to be try and be more clear about purpose of document and problem being solved.</t>
            <t>Many wording improvements and clarifications throughout the document.</t>
            <t>Filled in Security Considerations.</t>
            <t>Filled in IANA Considerations.</t>
            <t>Added to Acknowledgments those who participated in the Orlando ad-hoc discussion as well as those who participated in email discussion and side one-on-one discussions.</t>
        </list>
        </t>
      </section>
      
      <section title="Changes from draft-gellens-...-01 to -02">
        <t>
        <list style="symbols">
            <t>Updated text for (possible) new attribute "hlang" to reference RFC 5646</t>
            <t>Added clarifying text for (possible) re-use of existing 'lang' attribute saying that the registration would be updated to reflect different semantics for multiple values for interactive versus non-interactive media.</t>
            <t>Added clarifying text for (possible) new attribute "hlang" to attempt to better describe the role of language tags in media in an offer and an answer.</t>
        </list>
        </t>
      </section>

      <section title="Changes from draft-gellens-...-00 to -01">
        <t>
        <?rfc subcompact="yes" ?>
        <list style="symbols">
            <t>Changed name of (possible) new attribute from 'humlang" to "hlang"</t>
            <t>Added discussion of silly state (language not appropriate for media type)</t>
            <t>Added Voice Carry Over example</t>
            <t>Added mention of multilingual people and multiple languages</t>
            <t>Minor text clarifications</t>
        </list>
        </t>
      </section>

    </section>

    <section title="Contributors">
    <t>Gunnar Hellstrom deserves special mention for his reviews and assistance.
    </t>
    </section>
    
    <section title="Acknowledgments">
      <t>Many thanks to Bernard Aboba, Harald Alvestrand, Flemming Andreasen, Francois Audet, Eric Burger, Keith Drage, Doug Ewell, Christian Groves, Andrew Hutton, Hadriel Kaplan, Ari Keranen, John Klensin, Mirja Kuhlewind, Paul Kyzivat, John Levine, Alexey Melnikov, Addison Phillips, James Polk, Eric Rescorla, Pete Resnick, Alvaro Retana, Natasha Rooney, Brian Rosen, Peter Saint-Andre, and Dale Worley for reviews, corrections, suggestions, and participating in in-person and email discussions.</t>
    </section>

  </middle>

  <!--  *****BACK MATTER ***** -->

  <back>
    <!-- References split into informative and normative -->

    <!-- There are 2 ways to insert reference entries from the citation libraries:
     1. define an ENTITY at the top, and use "ampersand character"RFC2629; here (as shown)
     2. simply use a PI "less than character"?rfc include="reference.RFC.2119.xml"?> here
        (for I-Ds: include="reference.I-D.narten-iana-considerations-rfc2434bis.xml")

     Both are cited textually in the same manner: by using xref elements.
     If you use the PI option, xml2rfc will, by default, try to find included files in the same
     directory as the including file. You can also define the XML_LIBRARY environment variable
     with a value containing a set of directories to search.  These can be either in the local
     filing system or remote ones accessed by http (http://domain/dir/... ).-->

    <references title="Normative References">
      <?rfc include="reference.RFC.8174" ?>
      <?rfc include="reference.RFC.4566"?>
      <?rfc include="reference.RFC.5646"?>
      <?rfc include="reference.RFC.3261"?>
    </references>
    <references title="Informational References">
      <!-- <?rfc include="reference.RFC.3066"?> -->
      <!-- <?rfc include="reference.RFC.3840"?> -->
      <!-- <?rfc include="reference.RFC.3841"?> -->
      <?rfc include="reference.RFC.3264"?>
      <!-- <?rfc include="reference.I-D.saintandre-sip-xmpp-chat"?> -->
      <?rfc include="reference.RFC.8255"?>
      <!-- <?rfc include="reference.I-D.hellstrom-slim-modalitypref"?> -->
    </references>


    <!-- <section anchor="CallerPrefs" title="Historic Alternative Proposal: Caller-prefs">
    <t>The decision to base the proposal at the media negotiation level, and specifically to use SDP, came after significant debate and discussion.  It is possible to meet the objectives using a variety of mechanisms, but none are perfect.  Using SDP means dealing with the complexity of SDP, and leaves out real-time session protocols that do not use SDP.  The major alternative proposal was to use SIP.  Using SIP leaves out non-SIP session protocols, but more fundamentally, would occur at a different layer than the media negotiation.  This results in a more fragile solution since the media modality and language would be negotiated using SIP, and then the specific media formats (which inherently include the modality) would be negotiated at a different level (typically SDP, especially in the emergency calling cases), making it easier to have mismatches (such as where the media modality negotiated in SIP don't match what was negotiated using SDP).
    </t>
    <t>
    An alternative proposal was to use the SIP-level Caller Preferences mechanism from <xref target="RFC3840">RFC 3840</xref> and <xref target="RFC3841">RFC 3841</xref>.
    </t>
    <t>
    The Caller-prefs mechanism includes a priority system; this would allow different combinations of media and languages to be assigned different priorities. The evaluation and decisions on what to do with the call can be done either by proxies along the call path, or by the addressed UA. Evaluation of alternatives for routing is described in <xref target="RFC3841">RFC 3841</xref>.
    </t>

        <section title="Use of Caller Preferences Without Additions">
        <t>
        The following would be possible without adding any new registered tags:
        </t>
        <t>
        Potential callers and recipients MAY include in the Contact field in their SIP registrations media and language tags according to the joint capabilities of the UA and the human user according to <xref target="RFC3840">RFC 3840</xref>.
        </t>
        <t>
        The most relevant media capability tags are "video", "text" and "audio".
        Each tag represents a capability to use the media in two-way communication.
        </t>
        <t>
        Language capabilities are declared with a comma-separated list of languages that can be used in the call as parameters to the tag "language=". 
        </t>
        <t>
        This is an example of how it is used in a SIP REGISTER:
        </t>
        <t>
            <list>
            <t>
                <list style="hanging" hangIndent="12">
                    <t hangText="REGISTER">user@example.net
                    </t>
                    
                    <t hangText="Contact:">&lt;sip:user1@example.net&gt;
                     audio; video; text; language=&quot;en,es,ase&quot;
                    </t>
                </list>
            </t>
            </list>
        </t>
        <t>
        Including this information in SIP REGISTER allows proxies to act on the information.  For the problem set addressed by this document, it is not anticipated that proxies will do so using registration data.  Further, there are classes of devices (such as cellular mobile phones) that are not anticipated to include this information in their registrations.  Hence, use in registration is OPTIONAL.
        </t>
        <t>
        In a call, a list of acceptable media and language combinations is declared, and a priority assigned to each combination.
        </t>
        <t>
        This is done by the Accept-Contact header field, which defines different combinations of media and languages and assigns priorities for completing the call with the SIP URI represented by that Contact.  A priority is assigned to each set as a so-called "q-value" which ranges from 1 (most preferred) to 0 (least preferred).
        </t>
        <t>
        Using the Accept-Contact header field in INVITE requests and responses allows these capabilities to be expressed and used during call set-up.  Clients SHOULD include this information in INVITE requests and responses.
        </t>
        <t>
        Example:
        </t>
        <t>
            <list>
            <t>
                <list style="hanging" hangIndent="19">
                    <t hangText="Accept-Contact:"> *; text; language=&quot;en&quot;; q=0.2
                    </t>
                    <t hangText="Accept-Contact:"> *; video; language=&quot;ase&quot;; q=0.8
                    </t>
                </list>
            </t>
            </list>
        </t>
        
        <t>
        This example shows the highest preference expressed by the caller is to use video with American Sign Language (language code "ase").
        As a fallback, it is acceptable to get the call connected with only English text used for human communication. Other media may of course be connected as well, without expectation that it will be usable by the caller for interactive communications (but may still be helpful to the caller).
        </t>
        <t>
        This system satisfies all the needs described in the previous chapters, except that language specifications do not make any distinction between spoken and written language, and that the need for directionality in the specification cannot be fulfilled.
        </t>
        <t>
        To some degree the lack of media specification between speech and text in language tags can be compensated by only specifying the important medium in the Accept-Contact field.
        </t>
        <t>
        Thus, a user who wants to use English mainly for text would specify:
        </t>
        <t>
            <list>
            <t>
                <list style="hanging" hangIndent="19">
                    <t hangText="Accept-Contact:"> *;text;language="en";q=1.0</t>
                </list>
            </t>
            </list>
        </t>
        <t>
        While a user who wants to use English mainly for speech but accept it for text would specify:
        </t>
        <t>
            <list>
            <t>
                <list style="hanging" hangIndent="19">
                    <t hangText="Accept-Contact:">*;audio;language="en";q=0.8</t>
                    <t hangText="Accept-Contact:">*;text;language="en";q=0.2</t>
                </list>
            </t>
            </list>
        </t>
        
        <t>
        However, a user who would like to talk, but receive text back has no way to do it with the existing specification.
        </t>

        </section>

        <section title="Additional Caller Preferences for Asymmetric Needs">
        <t>
        In order to be able to specify asymmetric preferences, there are two possibilities. Either new language tags in the style of the hlang parameters described above for SDP could be registered, or additional media tags describing the asymmetry could be registered.
        </t>
        
            <section title="Caller Preferences for Asymmetric Modality Needs">
            <t>
            The following new media tags should be defined:
            </t>
            <t>
                <list>
                    <t>speech-receive</t>
                    <t>speech-send</t>
                    <t>text-receive</t>
                    <t>text-send</t>
                    <t>sign-send</t>
                    <t>sign-receive</t>
                </list>
            </t>
            <t>
            A user who prefers to talk and get text in return in English would register the following (if including this information in registration data):
            </t>
            <t>
                <list>
                <t>
                    <list style="hanging" hangIndent="12">
                        <t hangText="REGISTER">user@example.net</t>
                        <t hangText="Contact:">&lt;sip:user1@example.net&gt;                          audio;text;speech-send;text-receive;language="en"</t>
                    </list>
                </t>
                </list>
            </t>
            
            <t>
            At call time, a user who prefers to talk and get text in return in English would set the Accept-Contact header field to:
            </t>
            <t>
                <list>
                <t>
                    <list style="hanging" hangIndent="19">
                        <t hangText="Accept-Contact:">*; audio; text; speech-receive; text-send; language="en";q=0.8</t>
                        <t hangText="Accept-Contact:">*; text; language="en"; q=0.2</t>
                    </list>
                </t>
                </list>
            </t>
            <t>
            Note that the directions specified here are as viewed from the callee side to match what the callee has registered.
            </t>
            <t>
            A bridge arranged for invoking a relay service specifically arranged for captioned telephony would register the following for supporting calling users:
            </t>
            <t>
                <list>
                <t>
                    <list style="hanging" hangIndent="12">
                        <t hangText="REGISTER">ct@ctrelay.net</t>
                        <t hangText="Contact:">&lt;sip:ct1@ctreley.net&gt;                          audio; text; speech-receive; text-send; language="en"</t>
                    </list>
                </t>
                </list>
            </t>
            <t>
            A bridge arranged for invoking a relay service specifically arranged for captioned telephony would register the following for supporting called users:
            </t>
            <t>
                <list>
                <t>
                    <list style="hanging" hangIndent="12">
                        <t hangText="REGISTER">ct@ctrelay.net</t>
                        <t hangText="Contact:">&lt;sip:ct2@ctreley.net&gt;                          audio; text; speech-send; text-receive; language="en"</t>
                    </list>
                </t>
                </list>
            </t>
            <t>
            At call time, these alternatives are included in the list of possible outcome of the call routing by the SIP proxies and the proper relay service is invoked.
            </t>

            </section>
            
            <section title="Caller Preferences for Asymmetric Language Tags">
            <t>
            An alternative is to register new language tags for the purpose of asymmetric language usage.
            </t>
            <t>
            Instead of using "language=", six new language tags would be registered:
            </t>
            <t>
                <list>
                    <t>hlang-text-recv</t>
                    <t>hlang-text-send</t>
                    <t>hlang-speech-recv</t>
                    <t>hlang-speech-send</t>
                    <t>hlang-sign-recv</t>
                    <t>hlang-sign-send</t>
                </list>
            </t>
            <t>
            These language tags would be used instead of the regular bidirectional language tags, and users with bidirectional capabilities SHOULD specify values for both directions. Services specifically arranged for supporting users with asymmetric needs SHOULD specify only the asymmetry they support.
            </t>

            </section>

        </section>

    </section> -->




  </back>
</rfc>
