Alexa搭載モバイル製品の認可

AndroidアプリでLWAを使用するには、下の指示に従います。

• Amazon開発者ポータルでモバイルアプリを登録し、アプリのAPIキーを生成します。アカウントを作成してアプリを登録する方法については、「AVSスタートガイド」を参照してください。
• Android用Login with Amazonに移動し、ステップ1、4、および5を実行します。
• 次に、以下のステップを実行して、AVSで使用するLWAアクセストークンを取得します。

1. LWAをAndroidプロジェクトに追加します。「Login with Amazonプロジェクトを作成する」のLogin with Amazonライブラリをインストールするを参照してください。

2. LWA APIをソースファイルにインポートします。LWA APIをインポートするには、以下のimport文をソースファイルに追加します。

   import com.amazon.identity.auth.device.AuthError;

   import com.amazon.identity.auth.device.api.Listener;

   import com.amazon.identity.auth.device.api.authorization.AuthCancellation;
   
import com.amazon.identity.auth.device.api.authorization.AuthorizationManager;

   import com.amazon.identity.auth.device.api.authorization.AuthorizeListener;

   import com.amazon.identity.auth.device.api.authorization.AuthorizeRequest;

   import com.amazon.identity.auth.device.api.authorization.AuthorizeResult;
   
import com.amazon.identity.auth.device.api.authorization.Scope;
   import com.amazon.identity.auth.device.api.authorization.ScopeFactory;

   import com.amazon.identity.auth.device.api.workflow.RequestContext;
   

3. RequestContextを初期化します。

   RequestContextメンバー変数を宣言し、クラスの新しいインスタンスを作成する必要があります。インスタンスを作成するには、現在のアプリケーションコンテキストをstaticなファクトリーメソッドに渡します。RequestContextは、アクティビティのonCreateメソッド内で初期化することをお勧めします。例:

   private RequestContext mRequestContext;
   
   @Override
   protected void onCreate(Bundle savedInstance) {
       super.onCreate(savedInstance);
       mRequestContext = RequestContext.create(this);
   }
   

4. AuthorizeListenerImplを作成します。

   AuthorizeListenerImpl は、AuthorizeListener抽象クラスを拡張し、authorize呼び出しの結果を処理します。次の3つのメソッドが含まれます: onSuccess、onError、およびonCancel。onSuccessメソッドに渡されるAuthorizeResultオブジェクトには、アクセストークンが含まれます。

   private class AuthorizeListenerImpl extends AuthorizeListener {
   
       /* Authorization was completed successfully. */
       @Override
       public void onSuccess(final AuthorizeResult authorizeResult) {
       }
   
       /* There was an error during the attempt to authorize the application. */
       @Override
       public void onError(final AuthError authError) {
       }
   
       /* Authorization was cancelled before it could be completed. */
       @Override
       public void onCancel(final AuthCancellation authCancellation) {
       }
   }
   

5. AuthorizeListenerImplのインスタンスを作成し、登録します。

   AuthorizeListenerImplのインスタンスを作成し、RequestContextインスタンスに登録します。AuthorizeManager.authorizeの呼び出しが行われると、RequestContextインスタンスは、authorizeリクエストの結果を使用してAuthorizeListenerで適切なコールバックメソッドを呼び出します。AuthorizeListenerImplインスタンスは、onCreateメソッド内に登録することをお勧めします。

   @Override
   protected void onCreate(Bundle savedInstance) {
       super.onCreate(savedInstance);
       mRequestContext = RequestContext.create(this);
       mRequestContext.registerListener(new AuthorizeListenerImpl());
   }
   

6. onResumeメソッドをオーバーライドします。

   アクティビティ内のonResumeメソッドをオーバーライドします。RequestContextインスタンス上で、onResumeメソッドだけでなく、super.onResume()も呼び出します。これにより、RequestContextに対して、AuthorizeManager.authorize呼び出しからのコールバックの準備ができた場合にアプリが再開されると、AuthorizeListenerを呼び出すよう通知されます。

   @Override
   protected void onResume() {
       super.onResume();
       mRequestContext.onResume();
   }
   

7. AuthorizeManager.authorizeを呼び出します。

   Login with AmazonボタンのonClickハンドラーで、authorizeを呼び出し、ユーザーにログインしてアプリケーションを認可するよう求めます。このメソッドは、以下のいずれかの方法でユーザーを認可します。

   • システムブラウザに切り替え、ユーザーにサインインしてリクエストされた情報を承諾するよう求める。

   • セキュアなコンテキストでのウェブ表示に切り替え、ユーザーにサインインしてリクエストされた情報を承諾するよう求める。


   2つ目に記述されているセキュアなコンテキストは、現在、Android端末上のAmazonショッピングアプリとして利用できます。Fire OSを実行しているAmazon端末（KindleタブレットやFire TV端末など）は、端末上にAmazonショッピングアプリがなくても、常にこのオプションを使用します。このため、ユーザーがすでにAmazonショッピングアプリにサインインしていれば、シングルサインオン（SSO）機能により、このAPIはサインインページをスキップします。

   アプリケーションが認可されると、スコープと呼ばれる1つ以上のデータセットに対して認可されます。1つ目のパラメーターは、LWAからリクエストしているユーザーデータの範囲となるスコープの配列です。アプリに最初にログインすると、ユーザーに対してリクエストしているデータのリストが提示され、承認を求められます。AVSで使用するLWAでは、現在alexa:allスコープがサポートされています。

   認可の呼び出しは非同期で行われ、呼び出しの結果を使用してAuthorizeListenerImplインスタンスが呼び出されます。

   private RequestContext mRequestContext;
   private static final String PRODUCT_ID = "INSERT YOUR PRODUCT ID FROM AMAZON DEVELOPER CONSOLE";
   private static final String PRODUCT_DSN = "INSERT UNIQUE DSN FOR YOUR DEVICE";
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       mRequestContext = RequestContext.create(this);
       mRequestContext.registerListener(new AuthorizeListenerImpl());
   
       // Find the button with the login_with_amazon ID
       // and set up a click handler
       mLoginButton = (Button) findViewById(R.id.login_with_amazon);
       mLoginButton.setOnClickListener(new OnClickListener() {
           @Override
           public void onClick(View v) {
               final JSONObject scopeData = new JSONObject();
               final JSONObject productInstanceAttributes = new JSONObject();
   
               try {
                   productInstanceAttributes.put("deviceSerialNumber", PRODUCT_DSN);
                   scopeData.put("productInstanceAttributes", productInstanceAttributes);
                   scopeData.put("productID", PRODUCT_ID);
   
                   AuthorizationManager.authorize(new AuthorizeRequest.Builder(mRequestContext)
                       .addScope(ScopeFactory.scopeNamed("alexa:all", scopeData))
                       .forGrantType(AuthorizeRequest.GrantType.ACCESS_TOKEN)
   		                .shouldReturnUserData(false)
                       .build());
               } catch (JSONException e) {
                   // handle exception here
               }
           }
       });
   }
   

8. TokenListenerを作成します。

   Listener<AuthorizeResult, AuthError>インターフェースを実装します。リスナーがgetToken呼び出しの結果を処理します。リスナーには、onSuccessとonErrorの2つのメソッドが含まれます（getTokenをキャンセルできないため、onCancelはサポートされません）。onSuccess は、トークンデータとAuthorizeResultオブジェクトを受信します。一方、onErrorは、エラー情報とAuthErrorオブジェクトを受信します。

   public class TokenListener implements Listener<AuthorizeResult, AuthError> {
       /* getToken completed successfully. */
       @Override
       public void onSuccess(AuthorizeResult authorizeResult) {
       }
   
       /* There was an error during the attempt to get the token. */
       @Override
       public void onError(AuthError authError) {
       }
   }
   

9. AuthorizeListenerのonSuccessを実装します。

   onSuccessで、AmazonAuthorizationManager.getTokenを呼び出してアクセストークンを取り出します。getTokenは、authorize同様、非同期のlistenerインターフェースを使用します。getTokenの場合、インターフェースはListener<AuthorizeResult, AuthError>であり、AuthorizationListenerではありません。

   @Override
   public void onSuccess(Bundle response) {
       AuthorizationManager.getToken(this, new Scope[] { ScopeFactory.scopeNamed("alexa:all") }, new TokenListener());
   }
   

10. TokenListenerのonSuccessを実装します。

    onSuccess には、以下の2つのタスクがあります。

    • バンドルからアクセストークンを取り出す。
    • UIをログイン状態（ユーザーがログインしていることを示し、ログアウトする手段を提供する）に設定する。

    /* getToken completed successfully. */
    @Override
    public void onSuccess(AuthorizeResult authorizeResult) {
        String accessToken = authorizeResult.getAccessToken();
    }
    

11. アクティビティのonStartメソッドで、getTokenを呼び出し、アプリケーションがまだ認可されているかを確認します。

    • getToken は、未加工のアクセストークンを取り出します。このアクセストークンは、AVSへのリクエストを行う際に使用できます。
    • getToken には、authorizeの呼び出しでリクエストしたのと同じスコープが必要です。

    private static final Scope ALEXA_ALL_SCOPE = ScopeFactory.scopeNamed("alexa:all");
    
    @Override
    protected void onStart(){
        super.onStart();
        AuthorizationManager.getToken(this, new Scope[] { ALEXA_ALL_SCOPE }, new TokenListener());
    }
    

12. これで、AVSへのリクエスト時に使用できるアクセストークンが取得できました。